create-agent-skill

name	create-agent-skill
description	Cria uma `SKILL.md` padronizada para uso em VS Code Chat (Copilot Chat) e gera a versão correspondente adaptada para outros agentes do repositório (ex.: Claude). Automatiza frontmatter, templates e validações básicas.
user-invocable	true

Skill: create-agent-skill (VS Code Chat)

Resumo

• Propósito: gerar SKILLs padronizadas em .agents/skills/<skill-name>/SKILL.md e opcionalmente criar a contraparte em .claude/skills/<skill-name>/SKILL.md.
• Quando usar: padronizar skills novas, converter skills existentes para o formato do VS Code Chat / Claude ou criar boilerplate para novas automações.

Entrada (parâmetros)

• skill_name (string) — nome da skill / diretório (requerido).
• description (string) — curta descrição da skill (opcional, recomendada).
• targets (string[]) — onde criar: vscode, claude, ou both. Default: both.
• user_invocable (bool) — se a skill será invocável pelo usuário. Default: true.
• overwrite (bool) — sobrescrever arquivos existentes? Default: false.
• applyTo (optional) — paths onde a regra se aplica (opcional para skills de regras).

Saída esperada

• Cria as pastas necessárias e escreve os arquivos:
  • .agents/skills/<skill_name>/SKILL.md
  • opcionalmente .claude/skills/<skill_name>/SKILL.md
• Retorna lista de arquivos criados/alterados e avisos sobre conflitos.

Processo (passo-a-passo)

1. Valida skill_name (caracteres permitidos) e que o diretório alvo não contenha caracteres inválidos.
2. Detecta targets; se ausente pergunta ao usuário (prompt interativo).
3. Se existir arquivo e overwrite=false, mostra um diff resumido e pede confirmação antes de sobrescrever.
4. Gera conteúdo baseado em templates (veja seção Templates) e escreve com frontmatter consistente (name, description, user-invocable).
5. Para a versão Claude, adapta o texto e mantém as chaves essenciais do frontmatter; converte exemplos e prompts para um estilo mais orientado a instruções caso necessário.
6. Validações pós-gravação: frontmatter presente, name bate com o diretório, comprimento do arquivo ≤ 400 linhas (skill longa ok, mas recomenda-se sucinta).
7. Retorna resumo e caminhos; sugere próximo passo (criar PR, rodar yarn lint).

Templates

• Template mínimo para .agents/skills/<name>/SKILL.md:

---
name: <skill-name>
description: <Descrição curta da skill>
user-invocable: <true|false>
---

# <Skill Title>

Resumo

- O que faz: ...

Entrada

- `param1`: descrição

Processo

1. Passo 1
2. Passo 2

Exemplos de prompts

- "Crie uma regra X"

• Template correspondente em .claude/skills/<name>/SKILL.md (adaptação de estilo):

---
name: <skill-name>
description: <Descrição curta da skill, estilo Claude>
user-invocable: <true|false>
---

# <Skill Title> (Claude)

Resumo e quando usar

Passos rápidos

1. Passo A
2. Passo B

Exemplos de prompt

- "Gere um conjunto de regras para X"

Conversão e mapeamento de campos

• name → mantido.
• description → mantida, mas adaptar tom entre conciso (VS Code) e orientado a instruções (Claude) quando apropriado.
• user-invocable → mantido.

Validações e boas práticas

• name no frontmatter deve bater com o nome da pasta (ex.: create-agent-skill).
• Use espaços (não tabs) no frontmatter YAML.
• description é obrigatório para skills públicas.
• Evite longos blocos de código não documentados; prefira exemplos curtos.

Edge cases

• Se detectar um arquivo com frontmatter misto (ex.: chaves adicionais), não remova automaticamente; proponha um diff e peça confirmação.
• Em caso de conflito de nomes, sugira sufixos (-v2) e não sobrescreva.

Perguntas a fazer ao usuário (quando input ausente)

• Deseja criar a versão Claude também? (yes/no)
• Posso sobrescrever arquivos existentes? (yes/no)
• Qual o description da skill?

Exemplos de uso

• "Crie uma skill chamada generate-issue-body com descrição 'Gera issue body a partir de diff' e gere versão para Claude também."

---

Fim da skill.