AIKraft/Skills/markdown-mermaid-writing

markdown-mermaid-writing

Создаёт научную документацию в Markdown и диаграммы Mermaid (схемы, таймлайны). Полезно при запросах на текстовые структурные диаграммы или шаблоны документов.

KDK-Dense official Документы ★ 47.7k

Что делает навык

Создаёт научную документацию в Markdown с использованием диаграмм Mermaid для визуализации структур, схем и таймлайнов. Позволяет хранить редактируемый исходный код диаграмм в текстовом формате, что обеспечивает удобство контроля версий и совместимости с ИИ.

Когда применять

  • Написание отчётов, README, обзоров методов или исследовательских заметок в формате Markdown
  • Визуализация рабочих процессов, конвейеров данных, схем баз данных или состояний
  • Создание концептуальных карт, временных шкал или сравнительных диаграмм для обзоров литературы
  • Подготовка архитектурных схем и диаграмм зависимостей компонентов

Как работает

  1. Определите тип документа и проверьте наличие шаблона (например, templates/pull_request.md, templates/research_paper.md)
  2. Изучите руководство по стилю Markdown (references/markdown_style_guide.md) для соблюдения правил оформления
  3. Выберите подходящий тип диаграммы Mermaid и ознакомьтесь с её специфическим гайдом (references/diagrams/...)
  4. Напишите документ, используя шаблон и стиль, размещая диаграммы Mermaid inline рядом с соответствующим текстом
  5. Добавьте метаданные доступности (accTitle, accDescr) для поддерживаемых типов диаграмм и проверьте рендеринг в целевой среде
  6. Сохраните исходный .md файл, рендеринг и информацию о версии рендерера для обеспечения воспроизводимости

Примеры запросов агенту

Создай документацию проекта в Markdown с диаграммой Gantt для таймлайна задач
Напиши обзор методов исследования, используя диаграмму Mermaid для визуализации конвейера обработки данных
Подготовь README с архитектурной схемой системы в формате Mermaid C4

Что понадобится

  • Среда с поддержкой рендеринга Mermaid (GitHub, GitLab или локальные инструменты)
  • Доступ к файлам шаблонов и гайдов из репозитория scientific-agent-skills

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «markdown-mermaid-writing» из репозитория: # https://github.com/k-dense-ai/scientific-agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r markdown-mermaid-writing/ ~/.claude/skills/markdown-mermaid-writing/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.