backendПроверки: пройдено 4 · предупреждение 1

api-and-interface-design

Практические рекомендации по проектированию стабильных, документированных API и публичных интерфейсов.

Что это за skill и зачем он нужен

Навык содержит набор принципов и шаблонов для создания устойчивых API и интерфейсов: от закона Хайрума и правила «одна версия» до подхода «contract‑first», единой схемы ошибок, валидации на границах системы и предпочтения добавления новых полей вместо их изменения. Включены примеры REST‑эндпоинтов, пагинации, фильтрации, патч‑обновлений и типовых TypeScript‑интерфейсов (дискриминированные объединения, разделение входных/выходных моделей, брендинг ID). Также описаны типичные оправдания и «красные флажки», которые следует избегать.

Как установить

npx skills add https://github.com/addyosmani/agent-skills --skill api-and-interface-design

Когда использовать

Подходит

  • Разработка новых REST‑ или GraphQL‑эндпоинтов
  • Определение границ модулей и контрактов между командами
  • Создание типизированных пропсов для UI‑компонентов
  • Проектирование схемы БД, влияющей на форму API
  • Модернизация существующих публичных интерфейсов

Не подходит

  • Для одноразовых скриптов без публичного доступа
  • Когда требуется быстрый прототип без обязательств по совместимости
  • Для внутренних функций, которые никогда не будут использоваться извне

Проверки безопасности

RunlayerПредупреждение

Проверка вернула предупреждение. Перед установкой стоит просмотреть исходники, команды и доступы.

Gen Agent Trust HubПройдено

Проверка не нашла критичных проблем.

SnykПройдено

Низкий риск · проблем не найдено.

SocketПройдено

Предупреждений нет.

ZeroLeaksПройдено

Оценка 93/100 · проанализировано 2 раздела.

Похожие skills

diagnoseСистематизированный подход к отладке сложных программных ошибок.mattpocock/skills★ нет данных · 230.9K установокОткрыть →env-and-assets-bootstrapАвтоматизированная настройка окружения и подготовка ресурсов для репозиториев воспроизведения научных работ.lllllllama/ai-paper-reproduction-skill★ нет данных · 139.8K установокОткрыть →next-best-practicesНабор рекомендаций и проверок для написания и ревью кода на Next.js.vercel-labs/next-skills★ нет данных · 111.6K установокОткрыть →better-auth-best-practicesРуководство по настройке Better Auth: установка пакета, переменные окружения, конфигурация, CLI‑команды и рекомендации по использованию.better-auth/skills★ нет данных · 66.9K установокОткрыть →developing-genkit-jsПошаговое руководство по созданию, миграции и оптимизации приложений на Genkit JS с акцентом на безопасное управление учётными данными.firebase/agent-skills★ нет данных · 62.2K установокОткрыть →developing-genkit-dartAI‑SDK для Dart, предоставляющий единый интерфейс генерации кода, структурированных выводов, инструментов, потоков и агентов.firebase/agent-skills★ нет данных · 61.9K установокОткрыть →