api-designer

Designs clean, consistent REST and GraphQL APIs covering resource modeling, URL structure, versioning, pagination, filtering, error formats (RFC 9457 Problem Details), idempotency, authentication, rate limiting, and machine-readable contracts (OpenAPI 3.1 / GraphQL SDL). Use this skill when designing a new API or endpoint, reviewing an API design, choosing REST vs GraphQL, deciding on versioning or pagination...

Publisher type
Community
Repository
JayRHa/AgentSkills
Skill
api-designer
GitHub repository stars
5
npx skills add https://github.com/JayRHa/AgentSkills --skill api-designer

Agent skills can contain instructions that call tools or modify files. Review the source and permissions before installation.

What this resource does

api-designer is a reusable AI-agent instruction package published by JayRHa. It gives a compatible agent a repeatable procedure for work in this area: Founder workflows.

Best for

  • Founders and teams using an AI coding or work agent for tasks in this area: Founder workflows.
  • Repeatable work that matches this capability: Designs clean, consistent REST and GraphQL APIs covering resource modeling, URL structure, versioning, pagination, filtering, error formats (RFC 9457 Problem Details), idempotency, authentication, rate limiting, and machine-readable contracts (OpenAPI 3.1 / GraphQL SDL). Use this skill when designing a new API or endpoint, reviewing an API design, choosing REST vs GraphQL, deciding on versioning or pagination...
  • Users who want a publisher-defined workflow they can inspect before running.

What to prepare

  • A compatible AI agent that supports Agent Skills.
  • Access to the project or files the task will use.
  • Any provider accounts, command-line tools, or credentials requested by the skill.
  • A safe branch or backup when the skill may modify files.

How to use it

  1. Open the original repository and review SKILL.md, referenced files, scripts, and requested permissions.
  2. Copy the install command and run it from the workspace where you want to use api-designer.
  3. Reload or restart the agent if it does not discover the new skill immediately.
  4. Give the agent a concrete task in this area: Founder workflows. Explicitly name api-designer when you want to require its use.
  5. Review the proposed actions and output before approving file changes, shell commands, credentials, or external writes.

Example request

Use the api-designer skill for this task. First inspect the available context, explain the proposed approach, and wait for approval before any sensitive or destructive action.

Before you continue: Publisher category: Community. Publication in this catalog is not a security guarantee. Review the current repository before installation.

Source and review

Source check: 2026-09-05.

JayRHa