К основному содержанию
скилл CX Codex

discover-api — скилл для Claude Code: автоматическая подсказка по API

Скилл discover-api подключает специализированные знания об API-дизайне, аутентификации и авторизации автоматически, когда вы работаете с REST, GraphQL или вопросами безопасности. Экономит время на переключение между гайдами.

MIT 113 установок ★ 193 обновлён 2026-02-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rand/cc-polymath --skill discover-api -a claude-code
Открыть на GitHub

Что делает discover-api

discover-api — это шлюз к восьми специализированным скиллам по разработке API. Когда вы пишете код для REST или GraphQL, работаете с JWT, OAuth, rate limiting или версионированием, скилл загружается автоматически и предлагает нужный раздел.

Внутри восемь модулей: REST-дизайн, GraphQL-схемы, аутентификация, авторизация, rate limiting, версионирование, обработка ошибок и 35 правил API-дизайна. Каждый модуль можно загрузить отдельно или использовать готовые последовательности — например, для нового REST API это REST-дизайн → аутентификация → авторизация.

Скилл работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Требует Node.js для установки через npm.

Какие задачи решает

  • выбрать между REST и GraphQL для нового API
  • спроектировать ресурсы и HTTP-методы
  • внедрить JWT или OAuth 2.0
  • настроить role-based access control
  • защитить API от перегруза через rate limiting

Примеры запросов агенту

  • Какова правильная структура REST API для блога с пользователями, постами и комментариями?
  • Как добавить OAuth 2.0 в существующий API?
  • Как реализовать контроль доступа по ролям в GraphQL?

Как установить discover-api

1Через Skills CLI (Vercel)

npx skills add rand/cc-polymath --skill discover-api -a claude-code

2Вручную: положить файлы

~/.claude/skills/discover-api/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/discover-api/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о discover-api

Как установить discover-api в Claude Code?

Выполните команду npx skills add rand/cc-polymath --skill discover-api -a claude-code, затем загрузите скилл через ~/.claude/skills/discover-api/SKILL.md.

Что делает discover-api?

Это шлюз к 8 модулям по API: REST-дизайн, GraphQL, JWT/OAuth, role-based access control, rate limiting, версионирование и обработка ошибок. Загружается автоматически при работе с API.

В чём разница между api-authentication и api-authorization?

Аутентификация отвечает на вопрос «кто ты?» — это JWT, OAuth, ключи. Авторизация отвечает на «что ты можешь?» — это права доступа, роли, политики.

Исходный текст

SKILL.md · MIT
---
name: discover-api
description: Automatically discover API design skills when working with REST APIs, GraphQL schemas, API authentication, OAuth, JWT, rate limiting, API versioning, error handling, or endpoint design. Activates for backend API development tasks.
license: MIT
metadata:
  author: rand
  version: "4.0"
compatibility: Designed for Claude Code. Compatible with any agent supporting the Agent Skills format.
---

# API Skills Discovery

Provides automatic access to comprehensive API design, authentication, and implementation skills.

## When This Skill Activates

This skill auto-activates when you're working with:
- REST API design and implementation
- GraphQL schema design
- API authentication (JWT, OAuth 2.0, API keys, sessions)
- API authorization (RBAC, ABAC, permissions)
- Rate limiting and throttling
- API versioning strategies
- Error handling and validation
- HTTP methods, status codes, endpoints

## Available Skills

### Quick Reference

The API category contains 8 specialized skills:

1. **rest-api-design** - RESTful resource modeling, HTTP semantics, URL conventions
2. **graphql-schema-design** - GraphQL types, resolvers, N+1 problem prevention
3. **api-authentication** - JWT, OAuth 2.0, API keys, session management
4. **api-authorization** - RBAC, ABAC, policy engines, permission systems
5. **api-rate-limiting** - Token bucket, sliding window, rate limiting algorithms
6. **api-versioning** - API versioning, deprecation, backward compatibility
7. **api-error-handling** - RFC 7807 errors, validation, standardized responses
8. **api-design-rules** - 35 opinionated rules for API design

### Load Full Category Details

For complete descriptions and workflows:

Read ../api/INDEX.md


This loads the full API category index with:
- Detailed skill descriptions
- Usage triggers for each skill
- Common workflow combinations
- Cross-references to related skills

### Load Specific Skills

Load individual skills as needed:


# Core API design
Read ../api/rest-api-design.md
Read ../api/graphql-schema-design.md

# Security and access control
Read ../api/api-authentication.md
Read ../api/api-authorization.md

# Production hardening
Read ../api/api-rate-limiting.md
Read ../api/api-error-handling.md
Read ../api/api-versioning.md

# Rules and best practices
Read ../api/api-design-rules.md


## Common Workflows

### New REST API
**Sequence**: REST design → Authentication → Authorization

Read ../api/rest-api-design.md      # Resource modeling, HTTP methods
Read ../api/api-authentication.md   # User authentication
Read ../api/api-authorization.md    # Access control


### New GraphQL API
**Sequence**: GraphQL schema → Authentication → Authorization

Read ../api/graphql-schema-design.md  # Schema design, resolvers
Read ../api/api-authentication.md     # User authentication
Read ../api/api-authorization.md      # Field-level permissions


### API Hardening
**Sequence**: Rate limiting → Error handling → Versioning

Read ../api/api-rate-limiting.md    # Prevent abuse
Read ../api/api-error-handling.md   # Standardized errors
Read ../api/api-versioning.md       # Manage evolution


### Complete API Stack
**Full implementation from scratch**:


# 1. Design phase
Read ../api/rest-api-design.md

# 2. Security phase
Read ../api/api-authentication.md
Read ../api/api-authorization.md
Read ../api/api-rate-limiting.md

# 3. Production readiness
Read ../api/api-error-handling.md
Read ../api/api-versioning.md


## Skill Selection Guide

**Choose REST API skills when:**
- Building traditional web services
- Need simple CRUD operations
- Working with mobile apps or SPAs
- Require caching and HTTP semantics

**Choose GraphQL skills when:**
- Clients need flexible data fetching
- Reducing over-fetching or under-fetching
- Building aggregation layers
- Need strong typing for APIs

**Authentication vs Authorization:**
- **Authentication** (api-authentication.md): Who are you? (Login, JWT, OAuth)
- **Authorization** (api-authorization.md): What can you do? (Permissions, RBAC)

**Production considerations:**
- Always implement rate limiting for public APIs
- Use versioning from day one
- Standardize error responses early

## Integration with Other Skills

API skills commonly combine with:

**Database skills** (`discover-database`):
- API endpoints → Database queries
- Connection pooling for API servers
- Query optimization for API performance

**Testing skills** (`discover-testing`):
- Integration tests for API endpoints
- Contract testing for API consumers
- Load testing for API performance

**Frontend skills** (`discover-frontend`):
- API client libraries
- Data fetching patterns
- Error handling in UI

**Infrastructure skills** (`discover-infra`, `discover-cloud`):
- API deployment strategies
- Load balancing and scaling
- API gateways and proxies

## Usage Instructions

1. **Auto-activation**: This skill loads automatically when Claude Code detects API-related work
2. **Browse skills**: Run `Read ../api/INDEX.md` for full category overview
3. **Load specific skills**: Use bash commands above to load individual skills
4. **Follow workflows**: Use recommended sequences for common API patterns
5. **Combine skills**: Load multiple skills for comprehensive coverage

## Progressive Loading

This gateway skill (~200 lines, ~2K tokens) enables progressive loading:
- **Level 1**: Gateway loads automatically (you're here now)
- **Level 2**: Load category INDEX.md (~3K tokens) for full overview
- **Level 3**: Load specific skills (~2-3K tokens each) as needed

Total context: 2K + 3K + skill(s) = 5-10K tokens vs 25K+ for entire index.

## Quick Start Examples

**"Design a REST API for a blog"**:
Read ../api/rest-api-design.md


**"Add OAuth authentication to my API"**:
Read ../api/api-authentication.md


**"Implement role-based access control"**:
Read ../api/api-authorization.md


**"Prevent API abuse"**:
Read ../api/api-rate-limiting.md


**"Design an API versioning strategy"**:
Read ../api/api-versioning.md



**Next Steps**: Run `Read ../api/INDEX.md` to see full category details, or load specific skills using the bash commands above.

© rand · MIT · rand/cc-polymath

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
designing-apis CloudAI-X Скилл designing-apis в Claude Code проектирует REST и GraphQL API: структурирует эндпоинты, описывает форматы запросов и ответов, настраивает обработку ошибок и версионирование. CX Codex +1 ★ 1 424звёзд репо api-rate-limit-policy Samuel Berthe Скилл api-rate-limit-policy для Claude Code, Codex, Cursor и других агентов, который проектирует политику rate limit публичного API: модели измерения трафика, квоты по тирам, заголовки и поведение 429. CX Codex +1 10 400установок api-design Agent Skills Team Скилл api-design для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — проектирует или рефакторит контракты REST и GraphQL. Запускается, когда нужно зафиксировать форму API до начала реализации. CX Codex +1 390установок api-designer https://github.com/Jeffallan Скилл api-designer для архитектуры REST и GraphQL API с генерацией OpenAPI 3.1 спецификаций. Помогает моделировать ресурсы, планировать версионирование и задавать стандарты обработки ошибок. CX Codex +1 7 100установок API Designer daffy0208 Скилл API Designer помогает проектировать контракты REST и GraphQL с едиными правилами именования ресурсов, статус-кодами и пагинацией. CX Codex +1 204установок api-design-expert personamanagmentlayer Скилл api-design-expert для проектирования HTTP API: ресурсы REST, выбор между GraphQL и gRPC, схемы версионирования и единый формат ошибок. Полезен до того, как написан первый эндпоинт. CX Codex +1 180установок

Из того же набора19

Весь набор →
discover-database Скилл discover-database подбирает инструкции по SQL, NoSQL, оптимизации запросов и кэшированию под текущую задачу агента. CX Codex +1 125установок discover-networking Скилл discover-networking распознаёт задачи по сетям и подключению, затем помогает находить подходящие скиллы из набора cc-polymath. Пригодится при работе с протоколами, VPN и устойчивостью соединений. CX Codex +1 120установок discover-cryptography Скилл discover-cryptography автоматически подключает знания о шифровании, TLS, сертификатах и PKI когда вы работаете с криптографией. Загружается по требованию, не загромождая контекст. CX Codex +1 118установок discover-wasm Скилл discover-wasm для Claude Code подключает инструкции по WebAssembly, когда агент работает с Rust, wasm-pack или WASI. CX Codex +1 117установок discover-engineering Скилл discover-engineering для Claude Code подключает инженерные практики, шаблоны архитектурных документов и схемы Mermaid. Активируется при ревью кода и проектировании архитектуры. CX Codex +1 111установок discover-cicd Скилл discover-cicd автоматически находит нужные навыки по работе с GitHub Actions, Jenkins, GitLab CI и другими системами сборки, когда вы пишете конфиг или пайплайн. CX Codex +1 109установок discover-zig Скилл discover-zig для Claude Code распознаёт задачи по Zig и помогает открыть материалы по сборке, памяти и связи с C. CX Codex +1 108установок discover-security Скилл discover-security для Claude Code подбирает материалы по безопасности приложения для задач с авторизацией, проверкой ввода и поиском уязвимостей. Даёт агенту профильные инструкции по конкретной части проекта. CX Codex +1 107установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой