skillforge

skillforge is a Go CLI (binary name skillforge) that drafts and scaffolds OpenClaw-ready agent skill folders. It has two non-interactive subcommands, draft and init, plus a Bubble Tea TUI that launches when it is run with no arguments. Always use the non-interactive subcommands in an agent context; the TUI requires a live terminal and is not scriptable.

Workflow

1. Build or locate the skillforge binary.

   • From the tool's repository (github.com/itamaker/forge-skill): go build -o skillforge . (or make build, or go run . <subcommand> ... without a separate build step).
   • If installed via Homebrew (brew install itamaker/tap/skillforge) or a GitHub release, the skillforge binary is already on PATH.

2. If you only have a natural-language brief (and optionally a tool catalog), draft a skill spec first:

   • skillforge draft -brief <brief.md> [-catalog <tools.json>] [-out <spec.json>] [-name "<Explicit Name>"] [-max-tools <N>]
   • -brief is required; everything else is optional.
   • Without -catalog, the drafted spec gets a single placeholder tool (replace-me) that must be replaced with a real tool before the spec is useful.
   • Without -out, the drafted spec JSON prints to stdout instead of being written to a file.
   • -max-tools caps how many tools are retrieved from the catalog by keyword overlap with the brief (default 3).
   • The drafted spec infers name, slug, description, audience, category, tags, triggers, constraints, checks, examples, and workflow from the brief text — review and edit these before scaffolding, since they are heuristic guesses, not guaranteed-accurate metadata.