BB Markdown
Пишет, исправляет и преобразует Markdown, который одинаково отображается в каждом парсере — GitHub, MDX, Pandoc, сайтах документации, Slack, Notion. Используйте, когда список перестает вкладываться, таблица отображается как литеральные вертикальные черты, блок кода поглощает остальную часть файла, половина документа становится курсивом или ссылка-якорь приводит к ошибке 404; когда фронтматтер отображается как текст; когда сноски, списки задач, выноски, математика или Mermaid отображаются на GitHub, но не на сайте документации; когда MDX отклоняет `{`, `<` или HTML-комментарий; когда изображения в README ломаются на npm или PyPI; при преобразовании Markdown в PDF, DOCX или HTML, или HTML обратно в Markdown; когда markdownlint или Prettier конфликтуют с файлом в CI; при вставке в Slack, Discord, Notion, Confluence или Jira; и когда Markdown из недоверенного источника должен быть безопасно отображен. Не для LaTeX-документов (`latex`), файлов Word (`word-docx`), шаблонизированных PDF-документов, таких как отчеты, счета и контракты (`pdf-generator`), или стратегии документации и информационной архитектуры (`documentation`).
машинный переводПоказать оригиналСкрыть оригинал«Writes, fixes, and converts Markdown that renders the same in every pa…»
Writes, fixes, and converts Markdown that renders the same in every parser — GitHub, MDX, Pandoc, docs sites, Slack, Notion. Use when a list stops nesting, a table renders as literal pipes, a code fence swallows the rest of the file, half a document turns italic, or an anchor link 404s; when frontmatter shows up as text; when footnotes, task lists, callouts, math, or Mermaid render on GitHub but not on the docs site; when MDX rejects `{`, `<`, or an HTML comment; when a README's images break on npm or PyPI; when converting Markdown to PDF, DOCX, or HTML, or HTML back to Markdown; when markdownlint or Prettier fights the file in CI; when pasting into Slack, Discord, Notion, Confluence, or Jira; and when Markdown from an untrusted source has to be rendered safely. Not for LaTeX documents (`latex`), Word files (`word-docx`), templated PDF deliverables such as reports, invoices, and contracts (`pdf-generator`), or documentation strategy and information architecture (`documentation`).
Пишет, исправляет и преобразует Markdown, который одинаково отображается в каждом парсере — GitHub, MDX, Pandoc, сайтах документации, Slack, Notion.
Как процесс B 70/100 · Почти готов — слабые места: входы и предусловия, повторный запуск, отчётность по ходу
Как улучшить
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 1
✓ Критических и высоких находок нет
Средние и низкие: 1
-
низкая Рискованное назначение
intent-offensive-securitysecurity.md:23Наступательная безопасность / двойное назначение (допустимо для авторизованного тестирования; проверьте назначение)- Dangerous beyond `<script>`: `<style>` (exfiltration via CSS selectors, page defacement), `<iframe>`, `<object>`/`<embed>`, `<form>` (credential harvesting inside a trusted page), `<meta http-equiv=
Просканировано файлов: 20. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
name-formatname должен быть в kebab-case (строчные буквы, цифры, дефисы) - предупреждение
body-longтело SKILL.md ≈ 6415 токенов (рекомендуется < 5000); вынесите детали в references/ - заметка
frontmatter-keyнеизвестное поле фронтматтера "slug" - заметка
frontmatter-keyнеизвестное поле фронтматтера "homepage" - заметка
frontmatter-keyнеизвестное поле фронтматтера "changelog"
Процессный рейтинг: все десять параметров 70/100
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 14, без проверки текущего состояния
- 60Инструменты и файлы. Используются инструменты (bash, web), но во frontmatter они не объявлены
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 70Стоимость исполнения. Тело инструкции 6415 токенов
- 100Шаги. Шагов: 46
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Ошибки и развилки. Развилок: 1, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Разделов верхнего уровня: 12. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +3Длина description 994: рекомендуется 120–800 символов
- +4Нет примеров входа/выхода
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Описание говорит, когда скилл НЕ применять
- +4Структура: 12 заголовков
- +3Пошаговые инструкции: 46 пунктов
- +3Формат ответа описан явно
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 66.