Agent Skills
nklswbr/skills

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/skills

Skills

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.

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.

Structure
skills/
  <name>/
    SKILL.md        # the skill: frontmatter + workflow
    *.md            # references the skill loads when it needs them

Agents 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.