Суть
Что это за skill и зачем он нужен
Данный навык предоставляет руководство по проектированию масштабируемых и удобных для разработчиков API. Включает рекомендации по REST-архитектуре (ресурсно-ориентированный подход, методы HTTP, обработка ошибок) и GraphQL (схемоцентричный дизайн, использование DataLoader для оптимизации запросов, типизация).
Установка
Как установить
npx skills add https://github.com/wshobson/agents --skill api-design-principlesСценарии
Когда использовать
Подходит
- Разработка новых REST или GraphQL API
- Рефакторинг существующих интерфейсов для улучшения usability
- Установление стандартов API внутри команды
- Проверка спецификаций перед реализацией
- Миграция между архитектурными парадигмами
- Создание понятной документации API
Не подходит
- Для реализации конкретной бизнес-логики без привязки к архитектуре
- Если требуется готовая библиотека для интеграции (навык содержит рекомендации, а не код для внедрения)
Похожие
Похожие skills
diagnoseСистематизированный подход к отладке сложных программных ошибок.mattpocock/skillsОткрыть →env-and-assets-bootstrapАвтоматизированная настройка окружения и подготовка ресурсов для репозиториев воспроизведения научных работ.lllllllama/ai-paper-reproduction-skillОткрыть →next-best-practicesНабор рекомендаций и проверок для написания и ревью кода на Next.js.vercel-labs/next-skillsОткрыть →better-auth-best-practicesРуководство по настройке Better Auth: установка пакета, переменные окружения, конфигурация, CLI‑команды и рекомендации по использованию.better-auth/skillsОткрыть →developing-genkit-jsПошаговое руководство по созданию, миграции и оптимизации приложений на Genkit JS с акцентом на безопасное управление учётными данными.firebase/agent-skillsОткрыть →developing-genkit-dartAI‑SDK для Dart, предоставляющий единый интерфейс генерации кода, структурированных выводов, инструментов, потоков и агентов.firebase/agent-skillsОткрыть →