SKILLEMALL.ai
GitHub ↗ EN Войти

BC skill-creation-walkthrough

Пошаговое руководство по созданию собственных навыков Claude, от определения того, является ли навык подходящим инструментом, до написания файла SKILL.md, структурирования справочных материалов и обеспечения надежного срабатывания. Используйте, когда вы хотите упаковать рабочий процесс, фреймворк или повторяющуюся задачу в многоразовый навык, когда существующий навык не срабатывает или не загружает правильный контекст, когда вы аудируете неэффективный навык или когда вы хотите опубликовать навык для других. Также срабатывает, когда кто-то спрашивает «как мне создать навык» или «что делает хороший навык». Полезно для отдельных лиц, команд и всех, кто публикует навыки публично.

машинный переводПоказать оригиналСкрыть оригинал«Step-by-step guide for creating your own Claude Skills, from deciding…»

Step-by-step guide for creating your own Claude Skills, from deciding whether a skill is the right tool to writing the SKILL.md file, structuring reference material, and making it trigger reliably. Use when you want to package a workflow, framework, or repeated task into a reusable Skill, when an existing skill is not triggering or not loading the right context, when you are auditing a skill that is underperforming, or when you want to publish a skill for others. Also triggers when someone asks "how do I make a skill" or "what makes a good skill". Useful for individuals, teams, and anyone publishing skills publicly.

rampstackco/claude-skills Agent Skills автор: rampstackco 4 файла тело ≈ 3 284 токенов Открыть источникgithub.com↗ проанализирован 8 ч назад

Пошаговое руководство по созданию собственных навыков Claude, от определения того, является ли навык подходящим инструментом, до написания файла SKILL.md…

Как процесс C 61/100 · Есть пробелы — Скилл ссылается на файлы, которых нет в архиве: references/[noun]-template.md, references/[noun]-checklist.md, references/[noun]-playbook.md

ПроцедураИИ и агентытип и темы размечены автоматически по тексту скилла
Запускается в: Claude / Claude Code ChatGPT / Codex Gemini CLI Cursor GitHub Copilot / VS Code Qwen Code Kimi Code CLI Z.ai (GLM) DeepSeek (Deep Code) Mistral Vibe LangChain (deepagents) OpenClaw Goose OpenCode
JSON
Технический рейтинг
B
93/100
безопасность, качество, тесты
Безопасность 60%
100
Качество 40%
82
Прогон на моделях
не было
Процессный рейтинг
C
61/100
Есть пробелы
Скилл ссылается на файлы, которых нет в архиве: references/[noun]-template.md, references/[noun]-checklist.md, references/[noun]-playbook.md
Инструменты и файлы вес 18
0
Отчётность по ходу вес 2
0
Повторный запуск вес 4
30
три самых слабых из десяти параметров · все десять
Это копия скилла из другого каталога, в рейтинге считается основная: skill-creation-walkthrough (rampstackco/claude-skills)

Как улучшить

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

Находки guard · 0

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

Просканировано файлов: 4. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.

По спецификации Agent Skills

  • предупреждение missing-ref ссылка на отсутствующий файл: references/[noun]-template.md
  • предупреждение missing-ref ссылка на отсутствующий файл: references/[noun]-checklist.md
  • предупреждение missing-ref ссылка на отсутствующий файл: references/[noun]-playbook.md
  • предупреждение missing-ref ссылка на отсутствующий файл: references/example-[scenario].md
  • заметка frontmatter-key неизвестное поле фронтматтера "catalog_summary"
  • заметка frontmatter-key неизвестное поле фронтматтера "display_order"

Процессный рейтинг: все десять параметров 61/100

Не запустится. Скилл ссылается на файлы, которых нет в архиве: references/[noun]-template.md, references/[noun]-checklist.md, references/[noun]-playbook.md
  • 0Инструменты и файлы. Не хватает 4 файла(ов): references/[noun]-template.md, references/[noun]-checklist.md, references/[noun]-playbook.md
  • 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
  • 30Повторный запуск. Изменяющих операций: 3, без проверки текущего состояния
  • 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
  • 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
  • 70Входы и предусловия. Входные данные и предусловия перечислены
  • 85Шаги. Шагов: 69, расплывчатых формулировок: 1
  • 100Когда включается. Сказано, когда применять и когда не применять
  • 100Согласованность. Имя и обязательные поля на месте
  • 100Стоимость исполнения. Тело инструкции 3284 токенов
  • low Разделов верхнего уровня: 10. Похоже на несколько доменов в одном скилле

Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.

Сигналы качества

  • +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
  • +1Лицензия не указана
  • +2Инструкции на одном языке
  • +5В description 2 примера фраз-триггеров в кавычках
  • +3Длина description 623 символов: достаточно сигнала, не съедает бюджет
  • +4Структура: 20 заголовков
  • +3Пошаговые инструкции: 69 пунктов
  • +3Формат ответа описан явно
  • +4Есть примеры (1 блоков кода)
  • +4Справочные файлы упоминаются в инструкциях (3 из 3)

База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 82.