agent-skills-cli

Command-line tool for validating and working with Agent Skills.

Installation

cargo install agent-skills-cli

This installs the agent-skills binary.

Commands

validate

Check that a skill conforms to the specification:

agent-skills validate ./my-skill

✓ my-skill (./my-skill)

Accepts a skill directory, a path to SKILL.md, or - to read paths from stdin.

list

Discover skills in a directory:

agent-skills list ./skills

data-analysis    Analyze datasets and generate reports...
pdf-processing   Extract text from PDFs, fill forms...

Options: --recursive to search subdirectories, --check to validate each skill, --long for full details.

read-properties

Extract skill metadata as JSON, YAML, or TOML:

agent-skills read-properties ./my-skill --format json

{
  "name": "my-skill",
  "description": "Does something useful."
}

to-prompt

Generate XML for embedding skill metadata in agent prompts:

agent-skills to-prompt ./skill-one ./skill-two

Scripting and CI

• Exit codes: 0 on success, non-zero on failure
• JSON errors: --json for machine-readable error output
• Stdin support: Pass - to read paths from stdin
• Quiet mode: -q suppresses informational output

agent-skills validate ./my-skill || exit 1

Specification

Skills are validated against the Agent Skills specification.

License

MIT