Module surface 

Shared Clap-derived operator surface and Jinja fragments. Clap-derived operator metadata and shared MiniJinja fragments.

Clap remains the command grammar. Surface extracts the stable operator view used by committed skills and installed instructions, while the shared fragments own repeated invocation, version, and command-inventory prose.

Structs

Surface

Serializable operator-facing projection of one Clap command graph.

SurfaceArgument

One positional argument or flag in a Surface.

SurfaceCommand

One command in a Surface.

Enums

SurfaceRequirement

Whether Clap requires an argument.

SurfaceScope

How far Clap propagates an argument.

Constants

COMMANDS_FRAGMENT

Shared fragment that renders the visible top-level Clap commands.

INVOCATION_FRAGMENT

Shared fragment that renders mounted invocations and the no--- rule.

VERSION_FRAGMENT

Shared fragment that renders a skill frontmatter version line.

Functions

add_fragments

Add ctl-core’s shared operator fragments to an existing environment.

environment

Create a strict MiniJinja environment containing the shared fragments.

render

Render one operator template with a Surface and consumer-owned context.