O que mermaid-skill faz?
Diagramas Mermaid (.mmd) a partir de linguagem natural com loop de validação. 11+ tipos, multi-backend (mmdc / Kroki), PNG/SVG/PDF, multi-agente.
Visão Geral
Este skill permite que agentes de IA (como Claude Code, Cursor, Codex e outros) gerem diagramas Mermaid a partir de descrições em linguagem natural. Ele oferece suporte a mais de 11 tipos de diagramas, incluindo fluxograma, sequência, classe, estado, gantt, pizza, entidade-relacionamento, jornada do usuário, git, requisitos e timeline.
Como Funciona
- O usuário fornece uma descrição textual do diagrama desejado
- O skill utiliza a API de IA para gerar o código Mermaid correspondente
- Um loop de validação garante que o diagrama seja sintaticamente correto
- O diagrama é renderizado usando backend configurado (mmdc ou Kroki)
- O resultado é salvo nos formatos especificados (PNG, SVG, PDF)
Backends Suportados
- mmdc: Mermaid CLI - para renderização local
- Kroki: API de renderização remota
Formatos de Saída
- PNG
- SVG
Tipos de Diagrama
- Fluxograma
- Sequência
- Classe
- Estado
- Gantt
- Pizza
- Entidade-Relacionamento
- Jornada do Usuário
- Git
- Requisitos
- Timeline
Exemplo de Uso
Crie um diagrama de sequência mostrando o fluxo de autenticação do usuário
Integração Multi-Agente
Este skill foi projetado para funcionar em ambientes multi-agente, permitindo que diferentes agentes colaborem na criação e refinamento de diagramas.
Pré-requisitos
- Node.js (para mmdc)
- Acesso à internet (para Kroki)
Instalação
- Clone este repositório
- Configure as variáveis de ambiente
- Verifique a instalação do Mermaid CLI:
npm install -g @mermaid-js/mermaid-cli