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

Skill	Description	Docs
skill-optimizer	Kaizen for AI agent skills — observes execution, diagnoses friction, proposes concrete SKILL.md improvements	README
skill-map	Map, inspect and manage collections of interconnected Markdown skills, agents and docs — graph explorer + CLI + optional LLM layer. Lives in its own repo.	README

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:<skill-name>.

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
  workflows/              # CI (validate + auto-bump version)
  pull_request_template.md
scripts/
  validate-skills.py      # SKILL.md linter (used by CI and locally)
skills/
  _template/              # starting point for new skills
  skill-optimizer/
    SKILL.md              # skill definition (frontmatter + body)
    README.md             # user-facing docs
    references/           # optional, loaded on demand
CONTRIBUTING.md           # how to contribute
CODE_OF_CONDUCT.md        # community standards
SECURITY.md               # how to report vulnerabilities
CHANGELOG.md              # release notes
HUMAN.md                  # design notes for humans (not for agents)
CLAUDE.md                 # instructions for Claude / agents

Documents

• CONTRIBUTING.md — how to contribute, skill standard, PR workflow.
• CODE_OF_CONDUCT.md — community standards (Contributor Covenant v2.1).
• SECURITY.md — vulnerability reporting policy.
• CHANGELOG.md — release history.
• HUMAN.md — design principles and project vision (for humans).
• LICENSE — MIT.

Related projects

• skill-map — companion tool that maps, inspects and manages collections of Markdown-based skills, agents, commands and docs. Graph explorer + CLI + optional LLM layer. Works on any ecosystem of interconnected MDs (not limited to this repo).

License

MIT. See LICENSE.

---

Made by Crystian · LinkedIn