api-designer

An agent skill by Jeffallan, from Jeffallan/claude-skills. Tags: api, architecture, graphql, openapi, rest, web.

What it does

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.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add Jeffallan/claude-skills --skill api-designer

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/Jeffallan/claude-skills
cp -r claude-skills/skills/api-designer ~/.claude/skills/api-designer

Safety box score

Not rated yet. A safety box score grades what a skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. Anyone can request one from this page; it is saved for everyone. How the score works.

Source

Repository

Jeffallan/claude-skills (all skills from this repository)

Path

skills/api-designer/SKILL.md

Branch

main

Updated

2026-09-19

Related skills

• graphql-architect — Use when designing GraphQL schemas, implementing Apollo Federation, or building real-time subscriptions.
• spring-boot-engineer — Generates Spring Boot 3.x configurations, creates REST controllers, implements Spring Security 6 authentication flows, sets up Spring Data JPA repositories.
• aws-auth — Adds user authentication to web and mobile apps with Amazon Cognito (user pools and identity pools) and the AWS Amplify client auth libraries.
• aws-blocks — Guides building full-stack applications with AWS Blocks — an Infrastructure-from-Code framework.
• aws-networking — Routes AWS networking requests to the correct service skill for implementation.
• gh-cli — Enforces authenticated gh CLI workflows over unauthenticated curl, WebFetch, and MCP fetch patterns.