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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions