← Все навыки

api design principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.

Каталог из GitHub · что мы проверяем

Собираем навыки из Agentic Awesome Skills на GitHub. Это работы авторов сообщества, а не собственные разработки КОМЭКСПО. В карточках сохраняем источник и фиксированную версию.

Автоматические проверки

При импорте: проверяем адреса источников и убираем повторяющиеся идентификаторы. Некоторые категории риска исключаем.
При загрузке инструкции: проверяем формат SKILL.md, кодировку и объём. Ищем упоминания дополнительных файлов и инструментов.
Сверяем обозначение лицензии с разрешённым списком и учитываем известные исключения источника. Непонятные условия требуют отдельной проверки.

«Требует проверки» означает, что инструкция ещё не загружена и не проверена. Статусы совместимости не подтверждают безопасность, качество ответа или работу во всех моделях. Полный аудит кода, прав и тестирование каждого навыка не проводились. Скрипты не запускаем.

Авторы и условия использования

Оригинальные тексты коллекции заявлены под CC BY 4.0; у сторонних материалов могут быть другие условия. Открытый GitHub не означает отсутствие авторских прав. Сохраняйте авторство, ссылку на лицензию и отметки об изменениях.

Русские пояснения и промпт-обёртки подготовлены КОМЭКСПО. Оригинальные инструкции не переведены. Мы не связаны с GitHub или авторами навыков и не заявляем об их одобрении сервиса. Правообладателям: контакты — укажите карточку, оригинал и суть обращения.

Использовать навык

Без регистрации

Вставьте в свой ИИ-чат и замените последнюю строку своей задачей. Это инструкция, а не подключение новых инструментов.

Промпт для ИИ

Помоги выполнить мою задачу с опорой на навык «api design principles». Применяй только уместные инструкции. Не выдумывай факты и результаты действий. Если не хватает инструментов или данных — скажи об этом. Не запускай код и не передавай данные без моего поручения.

Источник: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/api-design-principles/SKILL.md. Лицензия: CC-BY-4.0.

---
name: api-design-principles
description: "Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time."
risk: safe
source: community
date_added: "2026-02-27"
---

# API Design Principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.

## Use this skill when

- Designing new REST or GraphQL APIs
- Refactoring existing APIs for better usability
- Establishing API design standards for your team
- Reviewing API specifications before implementation
- Migrating between API paradigms (REST to GraphQL, etc.)
- Creating developer-friendly API documentation
- Optimizing APIs for specific use cases (mobile, third-party integrations)

## Do not use this skill when

- You only need implementation guidance for a specific framework
- You are doing infrastructure-only work without API contracts
- You cannot change or version public interfaces

## Instructions

1. Define consumers, use cases, and constraints.
2. Choose API style and model resources or types.
3. Specify errors, versioning, pagination, and auth strategy.
4. Validate with examples and review for consistency.

Refer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.

## Resources

- `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.


Моя задача: [опишите задачу и приложите исходные материалы]

Agentic Awesome Skills — sickn33 и авторы коллекции. Описание автора; оригинальная инструкция без изменений. Авторство, исключения и лицензии: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
Оригинал: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/api-design-principles/SKILL.md
Лицензия: CC-BY-4.0 — https://creativecommons.org/licenses/by/4.0/
Авторство и исключения: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
SKILL.md сохранён без изменений. Промпт-обёртка и русские пояснения добавлены КОМЭКСПО. Сохраняйте уведомления авторов и условия лицензии при распространении. Авторы не заявляли об одобрении нашего сервиса. Материал предоставляется без гарантий.

Промпт попросит код-агента изучить фиксированную версию и предложить подключение к вашему проекту. Изменения требуют вашего согласования.

Промпт код-агенту

Подготовь подключение навыка «api design principles» к этому проекту. Сначала прочитай SKILL.md по фиксированной ссылке: https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/465ad05638fbe1d9e7f98671393396b6d9246393/skills/api-design-principles/SKILL.md. Версия: 465ad05638fbe1d9e7f98671393396b6d9246393. SHA-256 файла: 9e3a261c94e6b67e386a0c58532a4aedd924683bb8d6bde6bf90c5337a91195d. Лицензия: CC-BY-4.0. Проверь назначение, ограничения и доступные инструменты. Покажи, куда этот агент ожидает устанавливать навыки, и предложи точный план. Не перезаписывай существующие инструкции, не устанавливай зависимости, не запускай сторонние скрипты и не меняй права без отдельного согласования. Если инструкция ссылается на другие файлы, сообщи, какие отсутствуют. Моя задача: [опишите задачу].

Agentic Awesome Skills — sickn33 и авторы коллекции. Описание автора; оригинальная инструкция без изменений. Авторство, исключения и лицензии: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
Оригинал: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/api-design-principles/SKILL.md
Лицензия: CC-BY-4.0 — https://creativecommons.org/licenses/by/4.0/
Авторство и исключения: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
SKILL.md сохранён без изменений. Промпт-обёртка и русские пояснения добавлены КОМЭКСПО. Сохраняйте уведомления авторов и условия лицензии при распространении. Авторы не заявляли об одобрении нашего сервиса. Материал предоставляется без гарантий.

Скачать SKILL.md ↓

Источник: sickn33/agentic-awesome-skills · CC-BY-4.0 · Оригинал ↗

Атрибуция для копирования и распространения

Авторство и лицензия

Agentic Awesome Skills — sickn33 и авторы коллекции. Описание автора; оригинальная инструкция без изменений. Авторство, исключения и лицензии: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
Оригинал: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/api-design-principles/SKILL.md
Лицензия: CC-BY-4.0 — https://creativecommons.org/licenses/by/4.0/
Авторство и исключения: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
SKILL.md сохранён без изменений. Промпт-обёртка и русские пояснения добавлены КОМЭКСПО. Сохраняйте уведомления авторов и условия лицензии при распространении. Авторы не заявляли об одобрении нашего сервиса. Материал предоставляется без гарантий.

Если распространяете скачанный файл, приложите атрибуцию и требуемые лицензией уведомления автора. При изменении инструкции укажите свои изменения. Условия лицензии

Как это работает

Навык задаёт подход к задаче: например, как редактировать текст или проверять код. Вы выбираете его в чате — ИИ получает эту инструкцию вместе с вашим запросом.

Поддерживаются текст, код и создание сайтов. Навык не подключает новые модели, терминал, MCP или аккаунты. Для изображений и видео используются отдельные инструменты.

Совместимость: Инструкции для чата
Источник: sickn33/agentic-awesome-skills ↗
Версия: 465ad05638fb · фиксируется при добавлении
Лицензия: CC-BY-4.0
Звёзды репозитория: 47 140

Оригинальная инструкция SKILL.md · 1 793 символов

---
name: api-design-principles
description: "Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time."
risk: safe
source: community
date_added: "2026-02-27"
---

# API Design Principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.

## Use this skill when

- Designing new REST or GraphQL APIs
- Refactoring existing APIs for better usability
- Establishing API design standards for your team
- Reviewing API specifications before implementation
- Migrating between API paradigms (REST to GraphQL, etc.)
- Creating developer-friendly API documentation
- Optimizing APIs for specific use cases (mobile, third-party integrations)

## Do not use this skill when

- You only need implementation guidance for a specific framework
- You are doing infrastructure-only work without API contracts
- You cannot change or version public interfaces

## Instructions

1. Define consumers, use cases, and constraints.
2. Choose API style and model resources or types.
3. Specify errors, versioning, pagination, and auth strategy.
4. Validate with examples and review for consistency.

Refer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.

## Resources

- `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Личный кабинет

Другие возможности