skillgen

package

v0.248.0 Latest Latest Go to latest Published: Oct 7, 2026 License: MIT Imports: 6 Imported by: 0

Details

Package skillgen renders an urfave/cli v3 command tree into agent-facing discovery artifacts without making those artifacts runtime authority.

This section is empty.

This section is empty.

func RenderMarkdown(commands []*cli.Command, root string) string

RenderMarkdown walks commands and emits a deterministic markdown lookup table, one section per leaf verb:

func RenderYAML(commands []*cli.Command, root string) (string, error)

RenderYAML walks commands and emits a yaml document of Entry rows under a top-level `commands:` key. Each path is prefixed with root.

type Bundle struct {
	Name         string
	Skill        string
	CommandsYAML string
}

Bundle is one native agent skill plus its lazy command index.

func RenderSkill(commands []*cli.Command, root string) (Bundle, error)

RenderSkill builds a concise SKILL.md plus a complete lazy command index. Live help and describe output remain authoritative for command behavior.

type Entry struct {
	Path    []string `yaml:"path"`
	Summary string   `yaml:"summary,omitempty"`
	Flags   []string `yaml:"flags,omitempty"`
}

Entry is one reachable leaf in the structured YAML command index.