AF agent-config-lint
Проверяйте конфигурацию агента на наличие элементов, которые могут беззвучно ломаться на машине другого пользователя. Используйте перед публикацией или коммитом SKILL.md, AGENTS.md, CLAUDE.md или llms.txt, перед публикацией навыка на ClawHub, когда навык "работает на моей машине", но не у коллеги, когда навык не срабатывает, или когда вас просят проверить конфигурацию агента. Обнаруживает ссылки на несуществующие файлы, абсолютные пути в домашнем каталоге автора, необъявленные зависимости CLI, имя в frontmatter, которое не совпадает с каталогом навыка, и два навыка, описания которых настолько похожи, что агент запускает неправильный.
машинный переводПоказать оригиналСкрыть оригинал«Check agent config for things that break silently on someone else's ma…»
Check agent config for things that break silently on someone else's machine. Use before publishing or committing a SKILL.md, AGENTS.md, CLAUDE.md or llms.txt, before publishing a skill to ClawHub, when a skill "works on my machine" but not for a teammate, when a skill fails to trigger, or when asked to review agent config. Catches references to files that do not exist, absolute paths under the author's home directory, undeclared CLI dependencies, a frontmatter name that does not match the skill's directory, and two skills whose descriptions are so similar the agent fires the wrong one.
Проверяйте конфигурацию агента на наличие элементов, которые могут беззвучно ломаться на машине другого пользователя.
Как процесс F 39/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: scripts/build-report.py
Как улучшить
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
missing-refссылка на отсутствующий файл: scripts/build-report.py
Процессный рейтинг: все десять параметров 39/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): scripts/build-report.py
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Ошибки и развилки. Линейный процесс без обработки сбоев
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 50Когда включается. Не сказано, при каком запросе скилл включается
- 100Шаги. Шагов: 9
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 814 токенов
- 100Повторный запуск. Изменяющие операции проверяют текущее состояние
- low Ответ описан самодельной разметкой (3 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +3Формат ответа не описан: модель каждый раз решает сама
- -4Абсолютные локальные пути (C:\Users, /home/…): скилл не переносим
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Описание говорит, когда скилл НЕ применять
- +3Длина description 592 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 7 заголовков
- +3Пошаговые инструкции: 9 пунктов
- +4Есть примеры (5 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 78.