Skip to content

CLI Reference

FlagDescription
--help, -hShow help for a command
--version, -vShow the installed version
--verboseEnable verbose output
--quiet, -qSuppress non-error output
--no-colorDisable colored output

Create a new skill from a template.

Arguments:

  • <name> — Name of the skill to create (required)

Options:

FlagDefaultDescription
--template, -tbasicTemplate to use
--directory, -d./<name>Output directory
--no-gitfalseSkip git initialization
--no-installfalseSkip npm install

Examples:

Terminal window
skill-forge create my-skill
skill-forge create my-skill -t cli-tool
skill-forge create my-skill -d ~/skills/my-skill

Validate a skill’s structure and content.

Arguments:

  • [path] — Path to skill directory (default: current directory)

Options:

FlagDefaultDescription
--format, -ftextOutput format: text, json
--level, -lwarningMinimum severity to report
--fixfalseAuto-fix fixable issues

Exit codes:

  • 0 — All checks passed
  • 1 — One or more errors found
  • 2 — Invalid arguments

Publish the skill to the registry.

Options:

FlagDefaultDescription
--bumppatchVersion bump: major, minor, patch
--taglatestRegistry tag
--dry-runfalseSimulate without publishing
--no-githubfalseSkip GitHub release creation

List available templates.

Terminal window
skill-forge list
# Built-in:
# basic Minimal SKILL.md with references
# cli-tool CLI helper with scripts
# browser Browser automation
# code-review Code review and analysis
# custom Empty scaffold
#
# Custom:
# team-standard Our team's standard layout

Check that system requirements are met.

Terminal window
skill-forge doctor
# ✓ Node.js 22.14.0
# ✓ npm 11.11.0
# ✓ git 2.44.0
# ✓ Claude Code CLI authenticated
# ✓ GitHub CLI authenticated