{"id":"0ff80fc7-252f-45ea-9a32-acd6b6444393","shortId":"9XwTAE","kind":"skill","title":"Review REST API designs before implementation for versioning, security, and contract clarity","tagline":"Review an API design, endpoint set, or OpenAPI spec before implementation and return prioritized findings on design quality, security, resilience, and missing contract decisions.","description":"# Review REST API designs before implementation for versioning, security, and contract clarity\n\nReview an API design, endpoint set, or OpenAPI spec before implementation and return prioritized findings on design quality, security, resilience, and missing contract decisions.\n\n## Prerequisites\n\nClaude Code skill runtime\n\n## Installation\n\nRequirements and caveats from upstream:\n- | Language | TypeScript, Python, Go, Java, Rust, Ruby, C#, and more |\n- deploy/ — CI/CD pipelines, Docker, deploy scripts\n- **Skills 2.0:** allowed-tools: Read Grep Glob Write Bash(git *) — argument-hint: [path/to/scope] — auto-invokes on trigger phrases; requires git for churn analysis\n\nBasic usage or getting-started notes:\n- ├── article-example.md Article with callouts + code blocks\n- ├── meeting-brainstorm-example.md Brainstorming session\n- └── transcript-example.md Article with transcript appendix\n\n- Source: https://github.com/psenger/ai-agent-skills/tree/main/skills/review-api-design\n- Extracted from upstream docs: https://raw.githubusercontent.com/psenger/ai-agent-skills/HEAD/README.md\n\n## Documentation\n\n- https://github.com/psenger/Best-Practices-For-Rest-API\n\n## Source\n\n- [Agent Skill Exchange](https://agentskillexchange.com/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity/)","tags":["review","rest","api","designs","before","implementation","for","versioning","security","and","contract","clarity"],"capabilities":["skill","source-agentskillexchange","skill-review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity","topic-agent-skills","topic-ai-agents","topic-ai-tools","topic-awesome-list","topic-claude-code","topic-codex","topic-cursor","topic-llm","topic-mcp","topic-npx-skills","topic-openclaw","topic-skills-catalog"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/agentskillexchange/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add agentskillexchange/skills","source_repo":"https://github.com/agentskillexchange/skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,324 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:12:07.666Z","embedding":null,"createdAt":"2026-05-18T13:18:53.669Z","updatedAt":"2026-05-18T19:12:07.666Z","lastSeenAt":"2026-05-18T19:12:07.666Z","tsv":"'/psenger/ai-agent-skills/head/readme.md':157 '/psenger/ai-agent-skills/tree/main/skills/review-api-design':150 '/psenger/best-practices-for-rest-api':161 '/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity/)':168 '2.0':101 'agent':163 'agentskillexchange.com':167 'agentskillexchange.com/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity/)':166 'allow':103 'allowed-tool':102 'analysi':125 'api':3,15,39,51 'appendix':146 'argument':112 'argument-hint':111 'articl':134,143 'article-example.md':133 'auto':116 'auto-invok':115 'bash':109 'basic':126 'block':138 'brainstorm':140 'c':91 'callout':136 'caveat':81 'churn':124 'ci/cd':95 'clariti':12,48 'claud':74 'code':75,137 'contract':11,35,47,71 'decis':36,72 'deploy':94,98 'design':4,16,29,40,52,65 'doc':154 'docker':97 'document':158 'endpoint':17,53 'exchang':165 'extract':151 'find':27,63 'get':130 'getting-start':129 'git':110,122 'github.com':149,160 'github.com/psenger/ai-agent-skills/tree/main/skills/review-api-design':148 'github.com/psenger/best-practices-for-rest-api':159 'glob':107 'go':87 'grep':106 'hint':113 'implement':6,23,42,59 'instal':78 'invok':117 'java':88 'languag':84 'meeting-brainstorm-example.md':139 'miss':34,70 'note':132 'openapi':20,56 'path/to/scope':114 'phrase':120 'pipelin':96 'prerequisit':73 'priorit':26,62 'python':86 'qualiti':30,66 'raw.githubusercontent.com':156 'raw.githubusercontent.com/psenger/ai-agent-skills/head/readme.md':155 'read':105 'requir':79,121 'resili':32,68 'rest':2,38 'return':25,61 'review':1,13,37,49 'rubi':90 'runtim':77 'rust':89 'script':99 'secur':9,31,45,67 'session':141 'set':18,54 'skill':76,100,164 'skill-review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity' 'sourc':147,162 'source-agentskillexchange' 'spec':21,57 'start':131 'tool':104 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-tools' 'topic-awesome-list' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-llm' 'topic-mcp' 'topic-npx-skills' 'topic-openclaw' 'topic-skills-catalog' 'transcript':145 'transcript-example.md':142 'trigger':119 'typescript':85 'upstream':83,153 'usag':127 'version':8,44 'write':108","prices":[{"id":"0c1714ac-859f-4c29-8d4d-d2764889a69c","listingId":"0ff80fc7-252f-45ea-9a32-acd6b6444393","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"agentskillexchange","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:18:53.669Z"}],"sources":[{"listingId":"0ff80fc7-252f-45ea-9a32-acd6b6444393","source":"github","sourceId":"agentskillexchange/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity","isPrimary":false,"firstSeenAt":"2026-05-18T13:18:53.669Z","lastSeenAt":"2026-05-18T19:12:07.666Z"}],"details":{"listingId":"0ff80fc7-252f-45ea-9a32-acd6b6444393","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity","github":{"repo":"agentskillexchange/skills","stars":8,"topics":["agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex","cursor","llm","mcp","npx-skills","openclaw","skills-catalog"],"license":"mit","html_url":"https://github.com/agentskillexchange/skills","pushed_at":"2026-05-18T19:02:17Z","description":"The open catalog of AI agent skills — 2,000+ security-scanned skills for Claude Code, Cursor, Codex, and more.","skill_md_sha":"0c9b6a7b8509477ca459d1694bc59b89ac714a8c","skill_md_path":"skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"Review REST API designs before implementation for versioning, security, and contract clarity","description":"Review an API design, endpoint set, or OpenAPI spec before implementation and return prioritized findings on design quality, security, resilience, and missing contract decisions."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity"},"updatedAt":"2026-05-18T19:12:07.666Z"}}