skill-cli

CLI for managing and testing Anthropic Agent Skills (e.g. anthropics/skills).

Install (npm)

# Global
npm install -g ancoder-skill-cli

# Or run without installing
npx ancoder-skill-cli --help

The npm package is self-contained and includes prebuilt binaries for:

• macOS arm64
• macOS x64
• Linux arm64
• Linux x64
• Windows x64

After install, the wrapper selects the correct bundled binary for the current platform automatically.

Build from source (Go)

cd skill-cli
go build -o bin/skill-cli .
# Then run: ./bin/skill-cli --help
# Or via npm: node bin/skill-cli.js --help

Commands

| Command | Description | |--------|-------------| | skill-cli validate <path> | Validate SKILL.md, skill.contract.yaml, and evals/*.yaml | | skill-cli list [--path <dir>] | List installed skills | | skill-cli create <name> [--path <dir>] | Create a skill scaffold with contract and smoke eval templates | | skill-cli test <path> | Check that a skill has trigger docs, contract, and eval coverage | | skill-cli verify <path> [--suite smoke] | Run a machine-readable verification suite end-to-end | | skill-cli generate <name> --desc "..." | Generate a complete skill using Claude CLI (create → implement → verify) |

Machine-Readable Skill Layout

Task-oriented skills can now include a deterministic verification harness:

my-skill/
├── SKILL.md
├── skill.contract.yaml
├── evals/
│   └── smoke.yaml
├── fixtures/
└── scripts/

• skill.contract.yaml defines the executable contract: entrypoint, inputs, outputs, invariants, and datasets.
• evals/*.yaml defines runnable verification suites with deterministic checks like file existence, required content, and JSON assertions.
• skill-cli verify materializes fixture data into a temp workspace, runs the skill entrypoint, and enforces the declared checks.

skill-cli verify executes local code declared by the skill contract, so only run it against trusted skills and repositories.

Publish to npm

1. Set repository.url in package.json to your GitHub repo (e.g. git+https://github.com/your-org/skill-cli.git).

2. Build binaries per platform before publishing the npm package:

   bash scripts/build-all.sh

3. Optionally attach the same binaries to a GitHub Release with names:

   • skill-cli-darwin-arm64, skill-cli-darwin-x64
   • skill-cli-linux-x64, skill-cli-linux-arm64
   • skill-cli-win32-x64.exe

4. Publish the package:

   npm login --registry=https://registry.npmjs.org/
   npm publish --access public --registry=https://registry.npmjs.org/ --userconfig ~/.npmrc

Users who npm install -g ancoder-skill-cli get a fully bundled package. No extra binary download is required during install.

License

MIT