Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ancoder-skill-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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 --helpThe 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 --helpCommands
| 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.yamldefines the executable contract: entrypoint, inputs, outputs, invariants, and datasets.evals/*.yamldefines runnable verification suites with deterministic checks like file existence, required content, and JSON assertions.skill-cli verifymaterializes 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
Set
repository.urlinpackage.jsonto your GitHub repo (e.g.git+https://github.com/your-org/skill-cli.git).Build binaries per platform before publishing the npm package:
bash scripts/build-all.shOptionally attach the same binaries to a GitHub Release with names:
skill-cli-darwin-arm64,skill-cli-darwin-x64skill-cli-linux-x64,skill-cli-linux-arm64skill-cli-win32-x64.exe
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