Ding-Ye/learn-andrej-karpathy-skills

O que learn-andrej-karpathy-skills faz?

Recrie um carregador + registro + correspondente + linter de SKILL.md do zero em Go — um mecanismo por capítulo, cada um terminando com uma leitura de conteúdo upstream.

Visão Geral

Esta skill guia você através da implementação progressiva de um sistema completo para gerenciar skills de agentes de IA. Você construirá:

• Carregador (loader): Lê e analisa arquivos SKILL.md de um diretório ou repositório.
• Registro (registry): Mantém um catálogo de skills disponíveis.
• Correspondente (matcher): Combina consultas do usuário com skills apropriadas.
• Linter (linter): Valida a estrutura e o conteúdo de arquivos SKILL.md.

Cada capítulo termina com uma tarefa opcional de leitura de conteúdo upstream, incentivando você a aprender com implementações do mundo real.

Capítulos

1. Carregador de SKILL.md

Implemente um carregador que:

• Varre um diretório em busca de arquivos SKILL.md
• Analisa o cabeçalho YAML (se presente) e o corpo Markdown
• Retorna uma estrutura de dados representando a skill

type Skill struct {
    Name        string
    Description string
    Body        string
    Path        string
}

2. Registro de Skills

Construa um registro que:

• Armazena skills em um mapa
• Fornece métodos para adicionar, remover e listar skills
• Suporta busca por nome ou descrição

3. Correspondente de Skills

Implemente um correspondente que:

• Recebe uma consulta do usuário em linguagem natural
• Usa similaridade de cosseno ou correspondência de palavras-chave
• Retorna as N skills mais relevantes

4. Linter de SKILL.md

Desenvolva um linter que:

• Verifica se o arquivo SKILL.md segue o formato esperado
• Emite avisos para campos ausentes ou formatação incorreta
• Pode ser estendido com regras personalizadas

Exemplo de Uso

# Carregar skills de um diretório
./skill-loader load ./skills

# Listar skills registradas
./skill-loader list

# Encontrar skill para "como criar um agente de chat"
./skill-loader match "como criar um agente de chat"

# Validar skills
./skill-loader lint ./skills

Leitura Upstream

Ao final de cada capítulo, você é incentivado a ler:

• O código-fonte de claude-code no GitHub ou mirror
• A documentação oficial do formato SKILL.md
• Implementações de referência em projetos de código aberto

Contribuindo

Sinta-se à vontade para fazer fork, modificar e compartilhar suas implementações. Pull requests são bem-vindos!