skill-skill — Claude Code plugin: what it does, how to install
skill-skill writes agent skills that change what gets generated, then lints SKILL.md against the Agent Skills spec and scores its health from 0 to 100.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install skill-skill@awesome-codex-pluginsWhat skill-skill does
This one is a skill about writing skills. It pulls rules and checks out of real work: corrections, rejected drafts, accepted answers. Rather than advice, it pushes required artifacts and templates, plus checklists that run at a named moment. A reference file counts only when some step points at it.
The audit is a Python script, scripts/skill_audit.py. Point it at a skill folder or pass --all for ~/.claude/skills, and it reports names that break the lowercase-hyphen rule, descriptions with no trigger clause, name collisions, orphan files in references/, dangling paths, an oversized body. Python 3 is the only requirement; without it the script will not start.
There is also a quick effect test. Take two or three real prompts, write three observable effects for each, then compare the output with and without the skill. The description has to fit in 1,024 characters, since that string is all the agent reads before deciding to load anything.
What it helps with
- turn user corrections into rules and checks for a new skill
- lint SKILL.md for dangling paths and orphan reference files
- rewrite a description the agent never triggers on
- catch two skills sharing a name before publishing
- test on real prompts whether the skill changes output at all
Example prompts for the agent
- Write a skill for reviewing database migrations, using my corrections from past reviews as the checks.
- Run
scripts/skill_audit.pyon~/.claude/skills/my-skilland list what blocks the score. - Test the effect on three real prompts: three observable effects each, with and without the skill.
How to install skill-skill
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install skill-skill@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about skill-skill
How do I install skill-skill in Claude Code?
Add the marketplace first: /plugin marketplace add hashgraph-online/awesome-codex-plugins. Then install the plugin: /plugin install skill-skill@awesome-codex-plugins.
What does skill-skill do?
It helps you write a skill that fires at the right moment, then checks the finished SKILL.md with scripts/skill_audit.py and scores it from 0 to 100.
How is it different from Anthropic's skill-creator?
skill-creator runs full evals and tunes the description; this one gives a static lint in seconds and turns real corrections into checks. They cover different ground, and the author suggests running both.
Source text
skill-skill · MIT
# skill-skill  A Claude skill for writing skills that **actually change what gets generated**, not piles of notes. > **New: [I audited 899 public Claude skills](reports/2026-10/README.md)** ([中文](reports/2026-10/README.zh-CN.md)). Many never tell the model when to use them; fixes were sent upstream. > > [](reports/2026-10/README.md) 一个用来写 skill 的 skill:让 skill 在实际生成时真正起作用,而不是堆资料。 ## What it does - **Distil from real work.** Turns the user's corrections, rejections and accepted outputs into rules and checks. - **Forcing functions over advice.** Uses required artifacts, gates, scripts, checklists run at a named moment, and templates. References only count when a step points to them. - **Descriptions and names that trigger.** Covers trigger phrases (including Chinese), the 1024-char limit, and collision checks. - **Static audit** (`scripts/skill_audit.py`). Catches bad names, missing trigger clauses, name collisions, orphan reference files that nothing points to, dangling paths, oversized bodies and ALL-CAPS overuse. - **Quick effect test.** For 2–3 real prompts, writes 3 observable effects each, then checks them with and without the skill. ## Install In Claude Code: ``` /plugin marketplace add jack-reson8/skill-skill /plugin install skill-skill@skill-skill ``` Or as a plain skill folder: ```bash git clone https://github.com/jack-reson8/skill-skill /tmp/skill-skill && cp -R /tmp/skill-skill/plugins/skill-skill/skills/skill-skill ~/.claude/skills/ ``` **Codex** (CLI or the ChatGPT desktop app): ```bash codex plugin marketplace add jack-reson8/skill-skill codex plugin add skill-skill@skill-skill ``` Or copy `plugins/skill-skill/skills/skill-skill` into `~/.codex/skills/`. The skill follows the open [Agent Skills](https://agentskills.io) standard, so it works in Claude Code, Codex and any agent that reads SKILL.md. ## Audit any skill and get a health score ```bash python3 ~/.claude/skills/skill-skill/scripts/skill_audit.py path/to/skill # or --all for ~/.claude/skills, --badge for a README badge ``` ``` == bad-skill 15/100 ★☆☆☆☆ ✗ name "Bad_Skill" must be lowercase-hyphen ✗ description has no "Use when…" trigger clause ✗ orphan: references/orphan.md is never mentioned in SKILL.md ✗ dangling path: references/missing.md · warn: 4 ALL-CAPS commands — explain the why instead == pro-motion 100/100 ★★★★★ ✓ no blocking issues Average skill health: 92/100 across 6 skills ``` Audit any public repo into a report with a chart: `python3 scripts/skill_report.py owner/repo`. Got a score? Put the badge in your skill's README and share it (`--badge` prints the markdown). No dependencies beyond Python 3. For full eval benchmarks and description optimisation, pair it with Anthropic's `skill-creator`. ## FAQ **Why doesn't Claude use my skill?** Claude decides from the `description` alone. Say what the skill does *and when to use it*, using the phrases your users actually type, and stay under 1,024 characters. `skill_audit.py` flags descriptions that miss this. **What are the SKILL.md name rules?** A name is 1–64 lowercase letters, numbers and single hyphens, and it must match the parent folder ([Agent Skills spec](https://agentskills.io/specification)). **How is this different from Anthropic's skill-creator?** skill-creator runs full evals and description optimisation. skill-skill is the fast path: it distils real work into forcing functions and gives a static lint in seconds. Use both. Project page: https://jack-reson8.github.io/skill-skill/ ## License MIT
© jack-reson8 · MIT · hashgraph-online/awesome-codex-plugins