← All skills

design-an-api

100 / 100 · Low risk

Fine to try.

By testdouble/han (GitHub) · coding · 341 stars · scanned at commit abba73a

Designs the contract for an API change inside one codebase — a component's props, a function surface, URL or query parameters, an event payload, or a module boundary — through a discovery pass, an options document with one recommendation, a question round, and an adversarial validation round, with every element of the contract justified from one stated goal. Use when you want to design, shape, decide, or nail down an interface, contract, signature, or API change for a capability you can already…

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'design-an-api' ] || [ -L ~/.agents/skills/'design-an-api' ]; then echo 'A skill folder named design-an-api already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/testdouble/han' "$d" && git -C "$d" checkout --quiet 'abba73a773528905a8f3d15956029394746e5c7f' -- 'han-coding/skills/design-an-api' && mkdir -p ~/.agents/skills && cp -R "$d"/'han-coding/skills/design-an-api' ~/.agents/skills/'design-an-api' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'design-an-api' ~/.claude/skills/'design-an-api' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for testdouble/han shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/testdouble/han.svg)](https://zalavijaysinh.github.io/skilltrust/repos/testdouble/han/)

Score history