Passo-a-passo detalhado do skill, referenciando as fases cognitivas:
1SENSE — Descoberta e análise do input
Listar arquivos: `find . -name "*.md" -o -name "*.mdx"` via mcp-filesystem
Analisar estrutura: headings, código, tabelas, links, imagens por arquivo
Detectar formato de saída desejado e suas requirements específicas
2CONTEXTUALIZE — Mapear estrutura de navegação
Extrair hierarquia de headings para gerar sidebar automático
Resolver grafo de links: quais arquivos se referenciam mutuamente
Identificar docs de overview (README, index.md) vs. docs de referência
```bash
# Docusaurus: inicializar projeto
npx create-docusaurus@latest docs classic
# Copiar e converter arquivos
remark --use remark-gfm --use remark-mdx input/*.md --output docs/
```
Gerar frontmatter YAML para cada arquivo conforme o sidebar desejado:
```yaml
---
id: api-reference
title: API Reference
sidebar_label: API Reference
sidebar_position: 3
---
```
4EVALUATE — Verificar integridade
Checar links broken: `npx linkcheck ./docs/**/*.md`
Verificar que todos os arquivos têm frontmatter válido
Confirmar que imagens existem nos paths referenciados
5RECOMMEND — Output e configuração
Entregar arquivos convertidos no formato alvo
Gerar `docusaurus.config.ts` ou `book.toml` com configurações
Incluir CI workflow para rebuild automático da documentação em cada push
6REFLECT — Validação e telemetria
Validar preview local: `npm run start` no Docusaurus
Confirmar que busca, links e code highlighting funcionam
Reportar telemetria via mcp-skillschain
SynapticSkills