BD skill-creator
Руководство по созданию, проверке и валидации навыков агента (SKILL.md + metadata.json + references/ + scripts/) в этом репозитории навыков Capgo и аналогичных. Охватывает дизайн триггеров и негативных триггеров, лаконичный SKILL.md с индексом ссылок для определения времени загрузки, ловушки поверх основ, разделы проверки и обработки ошибок, версионирование фактов, навыки, ориентированные на под-агентов (разделение основного агента и под-агента), необязательный фронтматер when_to_use, встроенные снимки с разрешенными инструментами, оценки skillgrade и зеркалирование/регистрацию canonical skills/ в plugins/ в этом репозитории. Используйте при создании нового навыка, уточнении описания или триггеров навыка, разделении длинного навыка на ссылки или исправлении сбоев `bun run lint-skills`. Не используйте для документации приложений, README или маркетинговых материалов, или библиотечного кода, который не является навыком.
машинный переводПоказать оригиналСкрыть оригинал«Guides authoring, reviewing, and validating agent skills (SKILL.md + m…»
Guides authoring, reviewing, and validating agent skills (SKILL.md + metadata.json + references/ + scripts/) in this Capgo skills repository and similar ones. Covers trigger and negative-trigger design, lean SKILL.md with a when-to-load reference index, traps over basics, verification and error-handling sections, version tagging of facts, subagent-oriented skills (main-agent vs subagent split), optional when_to_use frontmatter, inline snapshots with allowed-tools, skillgrade evals, and this repo's canonical skills/ to plugins/ mirroring and registration. Use when creating a new skill, tightening a skill's description or triggers, splitting a long skill into references, or fixing `bun run lint-skills` failures. Do not use for app documentation, README or marketing copy, or library code that is not a skill.
Руководство по созданию, проверке и валидации навыков агента (SKILL.md + metadata.json + references/ + scripts/) в этом репозитории навыков Capgo и…
Как процесс D 47/100 · Процесс не доведён — Скилл ссылается на файлы, которых нет в архиве: references/<topic>.md
Как улучшить
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 1
✓ Критических и высоких находок нет
Средние и низкие: 1
-
низкая Широкие права
meta-dynamic-shellreferences/authoring-patterns.md:101Shell-команда, выполняемая автоматически при загрузке скилла (преамбула !`cmd` в Claude Code)!`node -e "const fs=require('fs');if(!fs.existsSync('package.json'))process.exit(0);..."`
Просканировано файлов: 6. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
missing-refссылка на отсутствующий файл: references/<topic>.md
Процессный рейтинг: все десять параметров 47/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): references/<topic>.md
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 6, без проверки текущего состояния
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 100Шаги. Шагов: 36
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1747 токенов
- low Ответ описан самодельной разметкой (9 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +3Длина description 816: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Описание говорит, когда скилл НЕ применять
- +4Структура: 15 заголовков
- +3Пошаговые инструкции: 36 пунктов
- +4Есть примеры (1 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (2 из 2)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 83.