← All skills

api-design

100 / 100 · Low risk

Fine to try.

By authgear/authgear-server (GitHub) · design · 2,149 stars · scanned at commit e66bfa3

Design or review Authgear APIs, and write or edit specs under docs/specs/. USE THIS BEFORE creating or editing any file in docs/specs/ — including adding a config field, GraphQL type, HTTP endpoint, or policy flag to an existing spec, or verifying a design draft. Covers the spec writing conventions (say it once, no implementation details, be concise, exact scope) and the API design checklist.

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/'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/authgear/authgear-server' "$d" && git -C "$d" checkout --quiet 'e66bfa3a9aabe5186ef14914a7d0d1fe45dfd23c' -- '.claude/skills/api-design' && mkdir -p ~/.agents/skills && cp -R "$d"/'.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 authgear/authgear-server shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/authgear/authgear-server.svg)](https://zalavijaysinh.github.io/skilltrust/repos/authgear/authgear-server/)

Score history