Agents Best Practices — скилл
agents-best-practices
Скилл проектирования агентных систем без привязки к вендору: архитектура цикла, инструменты, права, память и наблюдаемость
- 2 404 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скилл состоит только из инструкций и справочников
Установка
- Работает в
Ручная установка
npx skills add DenisSergeevitch/agents-best-practices -gФлаг -g ставит скилл на уровне пользователя для всех проектов.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл состоит только из инструкций и справочников
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл помогает проектировать, собирать MVP, аудировать, рефакторить и объяснять агентные обвязки для любой предметной области. Он задает базовую архитектуру: модель предлагает действие, обвязка проверяет схему, решает про права, выполняет или ставит на паузу для подтверждения, возвращает структурированное наблюдение и обновляет контекст. Разбор охватывает дизайн инструментов, лимиты цикла, компакцию контекста, память, скиллы, внешние коннекторы, наблюдаемость, оценки и безопасность. Подход не привязан к провайдеру и годится для кодинг-агентов, исследовательских задач, поддержки, операций, финансов, юридических и других процессов.
Для кого. Для инженеров и продуктовых команд, которые проектируют и разбирают агентные системы.
Подходит, если
- Проектируете обвязку агента для новой предметной области
- Аудируете существующего агента на надежность, стоимость и безопасность
- Выбираете между прямыми циклами инструментов, хостовыми инструментами и SDK
Не подходит, если
- Нужен обычный одноходовый текст, перевод или ответ на вопрос
- Задача не связана с проектированием агента
Пример запроса к агенту
Спроектируй MVP-обвязку для агента, который читает CRM и черновики писем, с подтверждением отправкиОграничения
Скилл дает архитектурные принципы и блюпринты, а не готовый код обвязки под конкретный фреймворк. Материал состоит только из инструкций и справочников.
Как отключить. Удалите папку agents-best-practices из каталога скиллов агента.
Частые вопросы
Только для кодинг-агентов?
Нет, принципы применимы к исследовательским, финансовым, юридическим, операционным и другим агентам.
Привязан ли скилл к одному API?
Нет, он провайдер-нейтральный и покрывает OpenAI, Anthropic и совместимые API.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкиллы по контекстной инженерии для агентов
Agent Skills for Context Engineering
Скиллы о проектировании агентных систем: управление контекстом, мультиагентные схемы, память, инструменты, оценка и харнесы
Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Скилл и хуки, которые удерживают кодового агента в рамках задачи и убирают лишнюю защиту, ненужные контрольные суммы и расползание объема
Скилл параллельной дивергентной генерации идей для агентов: расходится по когнитивным рамкам, отсеивает ловушки и углубляет лучшее
Скилл дисциплины завершения для крупных задач агента: сначала список приемки с проверками, потом работа, затем повторная сверка по доказательствам
Набор CLI-инструментов и скилл, которые дают текстовому агенту зрение: разбор изображений, OCR длинных скриншотов, восстановление UI
Коротко о README
README представляет провайдер-нейтральный скилл для проектирования, генерации MVP, аудита и рефакторинга агентных обвязок. Установка через npx skills с глобальным флагом, готовым промптом для агента или ручным клонированием в каталог скиллов. Приводится семь типовых сценариев, от генерации блюпринта под домен до аудита существующего агента с порядком исправлений. Ключевая идея: модель предлагает действия, а обвязка их проверяет, авторизует, выполняет и записывает. Лицензия MIT.
Бейдж для README
Исходный SKILL.md
--- name: agents-best-practices description: "Use this skill when designing, generating an MVP blueprint for, auditing, refactoring, or explaining an agentic harness for any domain. Covers provider-neutral agent architecture for OpenAI, Anthropic, and OpenAI-compatible APIs: agent loops, tool design, record provenance, interactive presentation, user-memory lifecycles, environment-adaptive tools, speculative tool execution, late-bound capabilities, permissions, system prompts, planning, goals, context compaction, memory, skills, MCP/external connectors, public-board communications, self-refining recursive harnesses, programmable context, continual refinement, observability, evals, prompt caching, agent-legible environments, feedback loops, and safety." metadata: version: "1.7.0" scope: "provider-neutral-agent-harness" file_policy: "markdown-only" --- # Agents Best Practices Use this skill when the user asks how to build, improve, debug, or evaluate an agentic harness.