crystools-skills

Open collection of AI agent skills — reusable, framework-agnostic SKILL.md packages for Claude Code and compatible agents.

Table of Contents

• What’s a skill?
• Available skills
• Install
• Update
• Contributing
• Project layout
• Documents
• License

What’s a skill?

A skill is a self-contained directory with a SKILL.md file. It packages “how to do X” in a way any SKILL.md-aware agent can execute, with no shared runtime and no global state. Copy it, fork it, move it between projects — it just works.

Skills follow a three-layer progressive disclosure model: lightweight frontmatter (for activation), a bounded body (for execution), and optional references (loaded on demand). See HUMAN.md for the design philosophy.

Available skills

More coming. Want to add one? Jump to Contributing.

Install

# All skills via Claude Code plugin
claude /plugin install crystian/skills

# All skills via npx
npx skills add crystian/skills

# A single skill
npx skills add crystian/skills --skill skill-optimizer

Once installed, invoke with the plugin namespace: /crystools-skills:.

Update

npx skills check                     # check for updates
npx skills update                    # update all
npx skills add crystian/skills       # reinstall latest

Contributing

Contributions are welcome — new skills, improvements, bug fixes, docs. Start here:

1. Read CONTRIBUTING.md.
2. For a new skill, open a New skill proposal first to align on scope.
3. Copy skills/_template/ as your starting point.
4. Open a PR; CI validates SKILL.md structure automatically.

Quick start for a new skill:

cp -r skills/_template skills/my-new-skill
# edit skills/my-new-skill/SKILL.md and README.md

Project layout

.claude-plugin/
  plugin.json             # plugin manifest
.github/
  ISSUE_TEMPLATE/         # issue forms