BD README Template
Генератор шаблонов README. Стандартный, список лучших, минималистичный, подробный, для библиотеки, приложения, API-проекта.
машинный переводПоказать оригиналСкрыть оригинал«README template generator. Standard, awesome-list, minimal, detailed,…»
README template generator. Standard, awesome-list, minimal, detailed, library, app, API project.
Генератор шаблонов README.
Как процесс D 42/100 · Процесс не доведён — слабые места: шаги, когда включается, входы и предусловия
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
Для прогона на моделях — необязательно
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 1
✓ Критических и высоких находок нет
Средние и низкие: 1
-
низкая Утечка данных
read-dotenvscripts/readme-template.sh:202Чтение файла .env (в кавычках — упоминание, а не команда)print("cp .env.example .env")в кавычках
Просканировано файлов: 5. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
name-formatname должен быть в kebab-case (строчные буквы, цифры, дефисы) - предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - заметка
frontmatter-keyнеизвестное поле фронтматтера "homepage" - заметка
frontmatter-keyнеизвестное поле фронтматтера "source"
Процессный рейтинг: все десять параметров 42/100
- 0Шаги. Инструкция сплошным текстом, шаги не выделены
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Ошибки и развилки. Линейный процесс без обработки сбоев
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 40Согласованность. Имя во frontmatter (README Template) не совпадает с папкой (readme-template)
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 100Инструменты и файлы. Внешние инструменты не нужны
- 100Стоимость исполнения. Тело инструкции 278 токенов
- 100Повторный запуск. Изменяющих операций нет
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 96: рекомендуется 120–800 символов
- +3Нет пошаговых инструкций или чек-листа
- -31 из 2 скриптов не упомянуты в SKILL.md
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Структура: 4 заголовков
- +3Формат ответа описан явно
- +4Есть примеры (1 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 59.
Внешние проверки
ClawHub: suspicious
The skill is presented as a README template helper, but the supplied scan evidence describes a broader local data-management script with persistent storage and logging that users would not reasonably expect.
LLM: suspicious (medium) · VirusTotal: · 29 мая 2026 г.