Навыки building-agents
🤖

building-agents

Низкий риск ⚡ Содержит скрипты📁 Доступ к файловой системе⚙️ Внешние команды

Создание агентов Claude Code

Создание агентов Claude Code требует понимания стандартов схем, лучших практик безопасности и правильной конфигурации инструментов. Этот навык предоставляет экспертное руководство по созданию надежных и безопасных агентов, следующих установленным шаблонам, и включает валидацию для обеспечения качества перед развертыванием.

Поддерживает: Claude Code(CC)
🥈 77 Серебро
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «building-agents». Создать новый агент для ревью кода

Ожидаемый результат:

  • Agent created: code-reviewer
  • Color: #3498DB (Blue - analysis domain)
  • Tools: Read, Grep, Glob (minimal, read-only)
  • Model: sonnet (balanced performance)
  • Next steps: Run validation with python3 scripts/validate-agent.py

Использование «building-agents». Проверить мой существующий агент на соответствие лучшим практикам

Ожидаемый результат:

  • Schema compliance: Passed
  • Naming: Passed (lowercase-hyphens, 12 chars)
  • Tools: Warning - Bash included without input validation guidance
  • Documentation: Passed (capabilities and workflow sections present)
  • Recommendation: Add input validation section or remove Bash from tools

Аудит безопасности

Низкий риск
v5 • 1/16/2026

Pure prompt-based skill for Claude Code agent creation. Static findings are false positives: hex color codes misidentified as MD5 hashes, markdown code blocks misidentified as shell backticks, and CLI command examples misidentified as reconnaissance. The skill includes a Python validation script that safely reads user-specified files without network access or credential handling.

9
Просканировано файлов
3,548
Проанализировано строк
4
находки
5
Всего аудитов
Проблемы низкого риска (1)
Bash tool in allowed-tools
The skill declares Bash in allowed-tools for running validation scripts. This is documented, expected behavior for an agent-builder skill, and runs within Claude Code's sandbox.

Факторы риска

⚡ Содержит скрипты (1)
📁 Доступ к файловой системе (1)
⚙️ Внешние команды (1)

Оценка качества

68
Архитектура
100
Сопровождаемость
87
Контент
30
Сообщество
88
Безопасность
96
Соответствие спецификации

Что вы можете построить

Создание агентов для плагинов

Создание специализированных агентов для вашего плагина, следуя установленным паттернам, цветам и соглашениям схемы

Стандартизация качества агентов

Обеспечение соответствия всех командных агентов требованиям схемы, стандартам безопасности и требованиям к документации

Расширение возможностей Claude

Создание пользовательских подагентов для конкретных доменов, таких как ревью кода, анализ безопасности или документация

Попробуйте эти промпты

Создать новый агент
Create a new agent named code-reviewer with blue color theme. It should review code for bugs and security issues. Use Read, Grep, Glob tools and sonnet model.
Проверить существующий агент
Review the security-auditor agent using the agent checklist. Check schema compliance, security, and content quality. Provide a score and recommendations.
Мигрировать старый агент
Migrate my-agent.md from old schema to current standards. Check validation status and apply update patterns for tool permissions and description clarity.
Сгенерировать из шаблона
Generate a new agent file using the agent template. Name it test-runner with red color. It should execute tests and report results. Include Bash tool for running test commands.

Лучшие практики

  • Начинайте с минимальных разрешений инструментов и добавляйте только при необходимости
  • Используйте скрипт валидации перед коммитом агентов для выявления проблем со схемой
  • Следуйте цветовым соглашениям доменов для визуальной согласованности между связанными агентами

Избегать

  • Включение инструмента Task в агенты (подагенты не могут порождать другие подагенты)
  • Избыточные разрешения инструментов, например, предоставление Bash без валидации входных данных
  • Создание агентов с расплывчатыми описаниями, которые не указывают, когда их вызывать

Часто задаваемые вопросы

Какие инструменты следует предоставить моему агенту?
Начинайте с минимального набора: Read, Grep, Glob. Добавляйте Write/Edit только для изменения файлов. Включайте Bash только для выполнения тестов или системных операций. Всегда валидируйте входные данные при включенном Bash.
Могут ли агенты порождать другие агенты?
Нет. Подагенты не могут использовать инструмент Task. Для оркестрации создайте навык вместо этого (навыки выполняются в основном потоке и могут использовать Task).
Как мне валидировать агент?
Запустите скрипт валидации: python3 agent-builder/skills/building-agents/scripts/validate-agent.py path/to/agent.md. Он проверяет синтаксис YAML, соглашения по именованию, обязательные поля и разрешения инструментов.
Безопасны ли мои данные с этим навыком?
Да. Навык получает доступ только к файлам, которые вы указываете. Скрипт валидации использует безопасный парсинг YAML и не делает сетевых запросов или сбора конфиденциальных данных.
Чем это отличается от навыков или команд?
Агенты — это специализированные подагенты с независимым контекстом, вызываемые явно через Task. Навыки автоматически вызываются на основе контекста. Команды — это вызываемые пользователем рабочие процессы с параметрами.
Какую модель мне следует выбрать?
Используйте haiku для простых задач (поиск, резюме), sonnet для большинства задач (сбалансированный), opus для сложных рассуждений. Сопоставляйте сложность модели с требованиями задачи.

Сведения для разработчиков