Dual-Forge/skills_overview

O que skills_overview faz?

Transforme ~/.agents/skills em um atlas HTML pesquisável: o sincronizador analisa cada SKILL.md (frontmatter YAML), gera uma página estática com filtros, tema claro/escuro, layout em estilo bento e caminhos prontos para copiar — sem servidor de desenvolvimento; abra skills-overview.html.

Funcionalidades

• Análise automática: Percorre recursivamente ~/.agents/skills e extrai o frontmatter YAML de cada SKILL.md.
• Página estática: Gera um único arquivo HTML (skills-overview.html) que pode ser aberto diretamente no navegador.
• Filtros dinâmicos: Permite filtrar skills por tags, palavras-chave ou outros metadados.
• Tema claro/escuro: Suporte nativo a tema claro e escuro, seguindo a preferência do sistema.
• Layout bento: Exibe as skills em um grid visualmente agradável, com cartões para cada skill.
• Caminhos copiáveis: Cada cartão exibe o caminho do diretório da skill, com um botão para copiá-lo para a área de transferência.

Como Usar

1. Execute o comando de sincronização:

   dual-forge sync
   

2. Abra o arquivo gerado:

   open skills-overview.html
   

3. (Opcional) Use a flag --watch para atualizar automaticamente quando SKILL.md for modificado:

   dual-forge sync --watch
   

Requisitos

• Node.js 18+ ou Python 3.9+ (dependendo do runtime configurado)
• Pasta ~/.agents/skills com subpastas contendo arquivos SKILL.md

Estrutura do Projeto

~/.agents/skills/
  ├── my-skill/
  │   └── SKILL.md
  ├── another-skill/
  │   └── SKILL.md
  └── skills-overview.html  (gerado)

Personalização

Edite o arquivo de configuração ~/.agents/skills/config.yaml para ajustar:

• Título da página
• Tema padrão (claro/escuro)
• Layout do grid (número de colunas)
• Metadados exibidos

Contribuição

Sinta-se à vontade para abrir issues ou enviar PRs no repositório Dual-Forge/skills_overview.

Licença

MIT