Communitygithub.com

ericforai/html-first-workflow

Skill para Claude Code/Codex: alternar para artefatos HTML de arquivo único em documentos entregáveis (especificações, PRDs, revisões, relatórios) mantendo markdown para chat/código.

O que é html-first-workflow?

Este skill permite que agentes de IA como Claude Code e Codex alternem automaticamente para artefatos HTML de arquivo único ao gerar documentação entregável (especificações, PRDs, revisões de código, relatórios), mantendo o formato markdown para conversas em chat e blocos de código. Com ele, documentos formais ganham formatação rica (tabelas, imagens, listas aninhadas, cores) sem depender de interpretadores markdown limitados, enquanto markdown permanece ideal para trechos de código e discussões rápidas no terminal. O workflow é ativado por palavras-chave no prompt (como "spec", "review", "report") e gera automaticamente um único arquivo HTML autocontido com estilo inline, links relativos e estrutura semântica (section, article, nav). Isso elimina a necessidade de múltiplos arquivos ou ferramentas externas para visualização de documentos complexos, otimizando o fluxo de trabalho de engenheiros de software que usam agentes de IA no terminal.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add ericforai/html-first-workflow

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que html-first-workflow faz?

Skill para Claude Code/Codex: alternar para artefatos HTML de arquivo único em documentos entregáveis (especificações, PRDs, revisões, relatórios) mantendo markdown para chat/código.

Visão Geral

Este skill configura automaticamente o comportamento do agente de IA para gerar documentação formal em HTML de arquivo único quando o contexto do prompt indicar um documento entregável. Para conversas casuais, código ou discussões rápidas, o markdown padrão continua sendo utilizado.

Como Funciona

  • Ativação: O skill é acionado quando palavras-chave como spec, PRD, review, report, design doc ou RFC aparecem no prompt inicial.
  • Geração: O agente produz um único arquivo HTML autocontido, com CSS inline, estrutura semântica (<section>, <article>, <nav>) e links relativos.
  • Fallback: Se o prompt não contiver palavras-chave de documento entregável, o agente usa markdown normalmente.

Exemplo de Uso

# Prompt que ativa o skill
$ claude "Crie uma especificação técnica para o novo módulo de autenticação"
# Saída: gera spec.html com formatação completa

# Prompt normal (markdown mantido)
$ claude "Explique como funciona o algoritmo de ordenação"
# Saída: markdown padrão

Configuração

Nenhuma configuração adicional é necessária. O skill funciona com Claude Code, Codex e outros agentes compatíveis que suportam a definição de skills via arquivo SKILL.md.

Suporte

  • Plataformas: Claude Code, Codex, Cursor (quando suportar skills)
  • Dependências: Nenhuma. HTML gerado é autocontido e não requer servidor web.

Licença

MIT

Habilidades Relacionadas