Skip to content

Auto-generate SKILL.md from CLI command catalog #7

@gmoon

Description

@gmoon

Requirement

REQ-CLI-020 — Auto-generate SKILL.md from CLI command catalog

Summary

lattice init --skill currently ships a static, hand-maintained SKILL.md template. When new commands or flags are added (like --files and --test-command on edit), the skill can go stale, causing agents to miss capabilities and fall back to editing YAML directly.

Instead, init --skill should generate the skill from lattice --json (the command catalog), ensuring it always reflects the current CLI surface.

Motivation

Inspired by gws (Google Workspace CLI) which auto-generates 92+ agent skills from its Discovery Document metadata via gws generate-skills. See SRC-GWS-CLI in the lattice.

Acceptance Criteria

  • lattice init --skill generates SKILL.md from the --json command catalog
  • All commands, parameters, and examples from the catalog appear in the generated skill
  • Hand-written workflow sections (Before/During/After work) are preserved via a template or merge strategy
  • RFC 2119 editing rules and cli-gap feedback loop are included in generated output
  • Generated skill is functionally equivalent to or better than the current hand-maintained version

Lattice

  • Derives from: THX-SKILL-AWARE-GRAPH
  • Source: SRC-GWS-CLI

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions