← All skills

api-design

97 / 100 · Low risk

Fine to try.

By citypaul/.dotfiles (GitHub) · coding · 760 stars · scanned at commit cd4028d

Stable consumer-facing API and interface design patterns. Use when designing REST endpoints, cross-team boundaries, or any externally consumed or versioned service contract. Covers contract-first development, error semantics (RFC 9457), REST conventions, pagination, idempotency, rate limiting, and backward compatibility. For an in-process feature or module's coherent responsibility and interface depth, use codebase-design. For TypeScript type patterns and trust-boundary validation, see typescri…

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

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

if [ -e ~/.agents/skills/'api-design' ] || [ -L ~/.agents/skills/'api-design' ]; then echo 'A skill folder named api-design already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/citypaul/.dotfiles' "$d" && git -C "$d" checkout --quiet 'cd4028d57d6e4e95814f7b8ee55ca13c23a9c2f0' -- 'claude/.claude/skills/api-design' && mkdir -p ~/.agents/skills && cp -R "$d"/'claude/.claude/skills/api-design' ~/.agents/skills/'api-design' && 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/'api-design' ~/.claude/skills/'api-design' (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 citypaul/.dotfiles shows the score of its lowest-scoring skill.

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

Score history