Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for resource modeling, versioning strategies, pagination patterns, error handling standards.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# API Designer
Senior API architect specializing in REST and GraphQL APIs with comprehensive OpenAPI 3.1 specifications.
## Core Workflow
1. **Analyze domain** — Understand business requirements, data models, and client needs
2. **Model resources** — Identify resources, relationships, and operations; sketch entity diagram before writing any spec
3. **Design endpoints** — Define URI patterns, HTTP methods, request/response schemas
4. **Specify contract** — Create OpenAPI 3.1 spec; validate before proceeding: `npx @redocly/cli lint openapi.yaml`
5. **Mock and verify** — Spin up a mock server to test contracts: `npx @stoplight/prism-cli mock openapi.yaml`
6. **Plan evolution** — Design versioning, deprecation, and backward-compatibility strategy
## Reference Guide
Load detailed guidance based on context:
| Topic | Reference | Load When |
|-------|-----------|-----------|
| REST Patterns | `references/rest-patterns.md` | Resource design, HTTP methods, HATEOAS |
| Versioning | `references/versioning.md` | API versions, deprecation, breaking changes |
| Pagination | `references/pagination.md` | Cursor, offset, keyset pagination |
…
The line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_jmf7vy56zvnmpw4a
GET https://markdownregistry.com/api/v1/resolve?ref=jahidulislamseo/antigravity-ai-skills/api-designer
GET https://markdownregistry.com/api/v1/blob/75a1d0df12641ef02803a1c8dba1e079f0b4cd7b238dd53ab4c257fad5b49e93
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
jahidulislamseo/antigravity-ai-skills · skills/academic-thesis-typesetter/SKILL.md · Use when formatting, standardizing, and typesetting academic dissertations, Master of Surgery (MS), Doctor of Medicine…
jahidulislamseo/antigravity-ai-skills · skills/agency-visual-report/SKILL.md · Use when creating ultra-professional, agency-grade client reports, visual HTML dashboards, and executive deliverables…
jahidulislamseo/antigravity-ai-skills · skills/ahrefs-tool/SKILL.md · When the user wants backlink analysis, link gap analysis, competitor link profiles, referring domain data, or link…
jahidulislamseo/antigravity-ai-skills · skills/ai-local-search/SKILL.md · When the user wants to optimize for AI-powered local search results including Google AI Overviews, AI Mode, ChatGPT…
jahidulislamseo/antigravity-ai-skills · skills/apple-business-connect/SKILL.md · When the user wants to optimize their Apple Maps listing, set up Apple Business Connect, or improve visibility in…
jahidulislamseo/antigravity-ai-skills · skills/architecture-designer/SKILL.md · Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions…
jahidulislamseo/antigravity-ai-skills · skills/atlassian-mcp/SKILL.md · Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying…
jahidulislamseo/antigravity-ai-skills · skills/bing-places/SKILL.md · When the user wants to optimize their Bing Maps listing, set up Bing Places for Business, or improve visibility in…
jahidulislamseo/antigravity-ai-skills · skills/brief/SKILL.md · Manages persistent work state (briefs) for local SEO engagements. Automatically load this skill when starting work on a…
jahidulislamseo/antigravity-ai-skills · skills/brightlocal-tool/SKILL.md · When the user wants citation audits, citation building, review monitoring across platforms, GBP audit scoring, or…
jahidulislamseo/antigravity-ai-skills · skills/chaos-engineer/SKILL.md · Designs chaos experiments, creates failure injection frameworks, and facilitates game day exercises for distributed…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/api-designer/SKILL.md · Generates complete, production-ready REST API endpoint specifications for any system or domain the user describes.
jeffallan/claude-skills · skills/api-designer/SKILL.md · Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for…
sandbaseai/sandbase-skills · marketing/api-designer/SKILL.md · Plan, implement, or review api designer work in an existing codebase with compatibility, security, and verification…
francostino/opencode-skills-collection · bundled-skills/api-designer/SKILL.md · Generates complete, production-ready REST API endpoint specifications for any system or domain the user describes.
zacklecon/claude-skills · skills/api-designer/SKILL.md · Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for…