Skip to main content
plugin CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install skill-skill@awesome-codex-plugins
Open on GitHub

What 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.py on ~/.claude/skills/my-skill and 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-plugins

Step 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

![skill health](https://img.shields.io/badge/skill%20health-100%2F100-brightgreen)

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.
>
> [![Claude skill health](reports/2026-10/chart.png)](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

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
spec-superflow spec-superflow — a plugin for direct or planned coding workflows with saved state, final review, and verification. Use it when a change needs a clear scope and a checkable finish. CX Codex ★ 1,596repo stars spec-driven spec-driven turns a feature idea into requirements, design and tasks, then lets the agent build them. CX Codex ★ 1,596repo stars sno-station-standalone The sno-station-standalone plugin for Claude Code and Codex reviews code, audits intent, and generates tests locally without accounts or external hooks. CX Codex ★ 1,596repo stars skill-sync-publisher skill-sync-publisher is a plugin for Claude Code and Codex that checks a local SKILL.md package and syncs it with GitHub and skill directories. It publishes one version to several registries. CX Codex ★ 1,596repo stars since-cutoff since-cutoff finds Python dependency changes after your model's knowledge cutoff and records short rules in AGENTS.md to stop the assistant from generating outdated API calls. CX Codex ★ 1,596repo stars simple-man The simple-man plugin cuts praise, recaps, and filler from agent replies while preserving actionable details. Use it when coding responses need less noise. CX Codex ★ 1,596repo stars sealos Deploys applications to Sealos Cloud directly from an agent, configuring databases, storage, and HTTPS with readiness checks. CX Codex ★ 1,596repo stars runtype-skills A skill bundle for building and operating AI products on Runtype, covering platform work, agent tools, Persona widgets, templates, and SDK workflows. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open