Formato de Skills do Thoth

Estrutura de Pastas

(seção não gerada — tente novamente)

Como Nomear uma Skill (Slug)

O slug é o identificador único da skill no repositório. Ele aparece no caminho da pasta (skills/<slug>/) e é usado internamente pelo Thoth para indexação e roteamento.

Regras obrigatórias

1. Formato kebab-case
   Use apenas letras minúsculas, números e hífens (-). Nunca use:

   • Espaços → marketing helper ❌
   • Underscores → marketing_helper ❌
   • CamelCase → MarketingHelper ❌
   • Caracteres especiais → marketing@helper ❌

2. Descritivo e específico
   O slug deve comunicar claramente o propósito da skill. Prefira verbos de ação + contexto:

   • ✅ briefing-extractor (extrai briefings de conversas)
   • ✅ horus-content-creator (cria conteúdo seguindo brand kit Horus)
   • ✅ calendar-scheduler (agenda eventos em calendário)
   • ❌ skill1, helper, marketing (genéricos demais)

3. Único no repositório
   Antes de criar, verifique se o slug já existe em skills/. Colisões causam falha no build.

Convenções recomendadas

Exemplos práticos

Bom:

• legal-brief-analyzer — analisa petições jurídicas
• seo-article-writer — escreve artigos otimizados para SEO
• client-intake-form — processa formulários de captação

Ruim:

• the-best-skill-ever — não descreve função
• Skill_Marketing — usa underscore e maiúscula
• helper — genérico demais
• skill-2024-01-15 — não deve incluir timestamps

Checklist rápido

• Usa apenas a-z, 0-9 e -?
• Tem entre 2 e 5 palavras?
• Comunica claramente o propósito?
• Não colide com slugs existentes em skills/?
• Evita termos genéricos ("helper", "tool", "skill")?

💡 Dica: Se você precisar de mais de 5 palavras, a skill provavelmente está fazendo coisas demais. Considere dividir em duas skills menores e mais focadas.

Anatomia do SKILL.md

(seção não gerada — tente novamente)

Frontmatter: Campos Obrigatórios e Opcionais

(seção não gerada — tente novamente)

Por Que a Description É Crítica?

(seção não gerada — tente novamente)

Corpo do SKILL.md: Seções Recomendadas

(seção não gerada — tente novamente)

Pasta references/: Quando e Como Usar

(seção não gerada — tente novamente)

Pasta templates/: Esqueletos de Saída

(seção não gerada — tente novamente)

Pasta scripts/: Helpers Executáveis

(seção não gerada — tente novamente)

Guardrails: Regras Não-Negociáveis

(seção não gerada — tente novamente)

Versionamento Semântico

(seção não gerada — tente novamente)

Pipeline de Build e Formatos Derivados

(seção não gerada — tente novamente)

Por Que Usar Apenas Caminhos Relativos?

(seção não gerada — tente novamente)

Checklist: Antes de Submeter uma Skill

(seção não gerada — tente novamente)