Get started
Agent Skills
Skills that help designers and engineers make better products: cut deeper, catch what breaks before users do, and hold the work to your own rules.
Install
Add all three to your agent with the skills CLI. Works with Claude Code, Cursor, Codex, and any agent that reads SKILL.md.
npx skills@latest add nklswbr/skillsSkills
Agents are good at adding. They add a setting nobody asked for, a reward that pays for the wrong behavior, a card inside a card. These skills push the other way.
- subtractMove forward by taking things away. Inventories a screen, flow, feature, copy, or module, runs each part down the ladder, and reports the cuts with before and after counts.
- break-game-theoryStress-tests your app’s incentives. Plays your app as its most rational, self-interested users, proves the worst exploits in dev, and proposes mechanism fixes that make honesty the best strategy.
- judgeJudge a page or component against your DESIGN.md. Every finding quotes the rule it breaks, and gaps in the document come back as proposed rules.
Why these skills
Agents add by default
Ask one to improve something and it reaches for another part, another step, another line of copy. People do the same: we systematically overlook subtractive changes. subtract makes removal the first option it considers, and counts what it saves.
Demo users play nice. Real users play the rules
A referral program, a free trial, a review system, a leaderboard: each one looks fair until someone does the math on it. break-game-theory does that math first, with the players you didn’t picture.
Taste doesn’t transfer, rules do
“Make it on brand” means nothing to the next agent. A DESIGN.md does. judge holds the work up against yours, quotes the rule for every failure, and turns every gap it finds into a new rule, so the same mistake doesn’t come back.
Anatomy of a skill
Each skill does one thing, has hard rules, a phased workflow with completion criteria, a fixed output format, and stops before changing anything until you say so.
skills/
<name>/
SKILL.md # the skill: frontmatter + workflow
*.md # references the skill loads when it needs themAgents read only the name and description at startup. The full SKILL.md loads when a task matches, and each reference file loads at the phase that names it.