Skills
.Work. You
Rest

design-apis

Official

Design robust APIs for humans and AI.

Software Engineering#api design#openapi#rest#graphql#grpc#agent-friendly api
Authorlushly-dev
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides expert guidance to design and review APIs, ensuring they are robust, maintainable, and easily consumable by both human developers and AI agents.

Core Features & Use Cases

  • API Design Guidance: Covers REST, GraphQL, and gRPC, including naming conventions, versioning, and error handling.
  • Agent-Friendly Patterns: Focuses on making APIs discoverable and usable by AI agents through OpenAPI and MCP integration.
  • Use Case: You are designing a new microservice API. Use this Skill to ensure your REST API follows best practices for resource modeling, error responses (RFC 9457), and includes an OpenAPI 3.1 spec that AI agents can easily consume.

Quick Start

Use the design-apis skill to get guidance on designing a REST API with versioning and error handling best practices.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: design-apis
Download link: https://github.com/lushly-dev/afd/archive/main.zip#design-apis

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.