SKILLEMALL.ai

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.

Cap-go/capgo-skills Agent Skills автор: Cap-go 6 файлов · 1 скрипт тело ≈ 1 747 токенов Открыть источникgithub.com↗ проанализирован 9 ч назад

Руководство по созданию, проверке и валидации навыков агента (SKILL.md + metadata.json + references/ + scripts/) в этом репозитории навыков Capgo и…

Как процесс D 47/100 · Процесс не доведён — Скилл ссылается на файлы, которых нет в архиве: references/<topic>.md

АнализаторТексты и документыИИ и агентытип и темы размечены автоматически по тексту скилла
JSON
Технический рейтинг
B
93/100
безопасность, качество, тесты
Безопасность 60%
99
Качество 40%
83
Прогон на моделях
не было
Процессный рейтинг
D
47/100
Процесс не доведён
Скилл ссылается на файлы, которых нет в архиве: references/<topic>.md
Инструменты и файлы вес 18
0
Результат и критерий готовности вес 14
0
Входы и предусловия вес 11
0
три самых слабых из десяти параметров · все десять
Это копия скилла из другого каталога, в рейтинге считается основная: skill-creator (Cap-go/capgo-skills)

Как улучшить

  1. В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
Для прогона на моделях — необязательно
  • Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
  • spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.

Находки guard · 1

✓ Критических и высоких находок нет

Средние и низкие: 1
  • низкая Широкие права meta-dynamic-shell references/authoring-patterns.md:101
    Shell-команда, выполняемая автоматически при загрузке скилла (преамбула !`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

Не запустится. Скилл ссылается на файлы, которых нет в архиве: references/<topic>.md
  • 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.