8 Habilidades de Agente e meu primeiro servidor MCP publicado no npm

🇧🇷 Ler este post em Português

Passei meses observando meu agente resolver os mesmos problemas, repetidamente, porque nunca me sentei e escrevi uma vez para que qualquer outra pessoa pudesse reutilizá-los. Esse é o tipo de dívida técnica que ninguém nunca coloca em um roadmap. Então, publiquei alpha-skills: oito Habilidades de Agente instaláveis e meu primeiro servidor MCP no npm.

Onde as habilidades publicadas estão

O catálogo instalável está em skills/, dividido em três categorias: external/ para APIs de terceiros, local/ para homelab e fluxos de trabalho, e general/ para utilitários de projeto cruzado. Todas as três são públicas: uma habilidade em external/, uma em local/, e seis em general/. local/ descreve o caso de uso.

skills/
├── external/
│   └── nextdns-api/SKILL.md
├── local/
│   └── progressive-search/SKILL.md
└── general/
    ├── agent-context-generator/SKILL.md
    ├── nestjs-iam-patterns/SKILL.md
    ├── nestjs-advanced-patterns/SKILL.md
    ├── nestjs-graphql/SKILL.md
    ├── tuning-claude-code/SKILL.md
    └── obsidian-second-brain/SKILL.md

<DIAGRAM 02: 02-public-skills-structure-pt.png>

As oito habilidades

Três categorias: external/ para serviços de terceiros, local/ para infraestrutura de homelab e fluxos de trabalho pessoais, general/ para utilitários transversais que não dependem de nenhum serviço específico.

Cada comando instala uma habilidade. Execute o comando para a que você precisa.

1. nextdns-api

Uma referência completa para a API REST do NextDNS: perfis, configurações de segurança/privacidade/controle parental, gerenciamento de listas de bloqueio e permissão, análises, logs de consulta. Este é o que o servidor MCP abaixo é construído diretamente.

npx skills add Alpha018/alpha-skills -s nextdns-api

2. progressive-search

O fluxo de descoberta que eu executo constantemente: perguntas de código vão para CodeGraph, perguntas de documentação vão para QMD, e ele recorre ao grep/find quando nenhum dos dois responde. Ele mantém um gráfico em sessão do que já foi encontrado, para que nunca repita uma busca.

npx skills add Alpha018/alpha-skills -s progressive-search

3. agent-context-generator

Gera, atualiza ou audita um CLAUDE.md/AGENTS.md de projeto, fundamentado no que o repositório realmente contém: dependências reais, estrutura de pastas real, scripts reais. Não é um template genérico que assume uma pilha que você não possui.

npx skills add Alpha018/alpha-skills -s agent-context-generator

4. nestjs-iam-patterns

Padrões de autenticação e autorização para NestJS: JWT de acesso/atualização, autenticação de sessão com Passport e Redis, chaves de API, RBAC, permissões granulares, ABAC, Google Sign-In, TOTP/2FA. Liderado por um guia de decisão para qual padrão se encaixa na sua situação real, não um catálogo de todos eles.

npx skills add Alpha018/alpha-skills -s nestjs-iam-patterns

5. nestjs-advanced-patterns

Internos avançados do NestJS: tokens DI explícitos e implícitos, módulos dinâmicos, descoberta em tempo de execução, provedores duráveis, threads de trabalho, circuit breaker, gateways WebSocket, e uma tabela de decisão para escolher um transportador de microserviço através de TCP, Redis, MQTT, NATS, RabbitMQ, Kafka, gRPC.

npx skills add Alpha018/alpha-skills -s nestjs-advanced-patterns

6. nestjs-graphql

Uma habilidade cobrindo tanto GraphQL com código primeiro quanto esquema primeiro no NestJS, com uma tabela de decisão que direciona cada tarefa para exatamente um arquivo de referência, para que o agente nunca carregue ambas as partes ao mesmo tempo. Cobre assinaturas com PubSub/Redis, o problema N+1 resolvido com DataLoader, guards tipados, limites de profundidade e custo de consulta, e uma seção de endurecimento de produção verificada contra a fonte real do Apollo Server, não contra o que eu me lembrava.

npx skills add Alpha018/alpha-skills -s nestjs-graphql

7. tuning-claude-code

Desenha toda a pilha de configuração do Claude Code para um repositório: CLAUDE.md tratado como um orçamento de tokens, regras de escopo de caminho, subagentes personalizados, hooks determinísticos, uma lista de MCP podada, worktrees paralelos, e CI sem cabeça.

npx skills add Alpha018/alpha-skills -s tuning-claude-code

8. obsidian-second-brain

Um guia de decisão para executar um cofre Obsidian como um sistema de conhecimento que realmente sobrevive ao contato com o uso real. Ele se afasta do teatro da produtividade e sobrecarga de plugins, escolhe um organizador principal (pastas PARA para trabalho de entrega, links Zettelkasten para geração de ideias), e afirma claramente quando o Obsidian é a ferramenta errada.

npx skills add Alpha018/alpha-skills -s obsidian-second-brain

O estilo que essas habilidades compartilham

Nenhuma das habilidades general/ começou a partir de um guia de estilo escrito. Mas