8 Habilidades de Agente e Meu Primeiro Servidor MCP Publicado no NPM

🇺🇸 Leia este post em inglês

Estou há meses fazendo com que meu agente resolva os mesmos problemas repetidamente porque nunca tirei o tempo para escrevê-los uma única vez, corretamente, e deixar que outros os reutilizassem. Esse é exatamente o tipo de dívida técnica que ninguém coloca em um roadmap. Então, publiquei alpha-skills: oito habilidades de agente instaláveis e meu primeiro servidor MCP no npm.

Onde estão as habilidades publicadas

O catálogo instalável vive em skills/, separado em três categorias: external/ para APIs de terceiros, local/ para homelab e fluxos de trabalho, e general/ para utilidades transversais. As três são públicas: uma habilidade em external/, uma em local/ e seis em general/. local/ descreve seu âmbito 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

As oito habilidades

Três categorias: external/ para serviços de terceiros, local/ para infraestrutura de homelab e workflows próprios, general/ para utilidades transversais que não dependem de nenhum serviço em particular.

Cada comando instala uma habilidade. Execute o que você precisar.

1. nextdns-api

Referência completa da API REST do NextDNS: perfis, segurança/privacidade/controle parental, listas de bloqueio e permitidas, análises, logs de consultas. É a que dá suporte ao servidor MCP que descrevo mais abaixo.

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

2. progressive-search

O fluxo de descoberta que uso o tempo todo: perguntas de código vão para o CodeGraph, perguntas de documentação vão para o QMD, e se nenhum responde, cai para grep/find. Mantém um grafo na sessão do que já foi encontrado para não repetir buscas.

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

3. agent-context-generator

Gera, atualiza ou audita o CLAUDE.md/AGENTS.md de um projeto baseado no que o repositório realmente tem: dependências reais, estrutura real, scripts reais. Não em um template genérico que assume uma pilha que não existe.

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

4. nestjs-iam-patterns

Padrões de auth/authz no NestJS: JWT access/refresh, sessões com Passport e Redis, API keys, RBAC, permissões granulares, ABAC, Google Sign-In, TOTP/2FA. Liderada por uma guia de decisão: qual padrão corresponde à sua situação, não um catálogo de todos eles.

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

5. nestjs-advanced-patterns

Internals avançados do NestJS: tokens de DI explícitos e implícitos, módulos dinâmicos, discovery em runtime, providers duráveis, worker threads, circuit breaker, WebSocket gateways, e uma tabela de decisão para escolher transporter em microserviços (TCP, Redis, MQTT, NATS, RabbitMQ, Kafka, gRPC).

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

6. nestjs-graphql

Uma única habilidade que cobre code-first e schema-first 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 as duas metades ao mesmo tempo. Cobre subscriptions com PubSub/Redis, o problema N+1 resolvido com DataLoader, guards tipados, limites de profundidade e custo de queries, e uma seção de hardening de produção verificada contra o código fonte real do Apollo Server, não contra o que eu lembrava de memória.

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 orçamento de tokens, regras por path, subagentes personalizados, hooks determinísticos, uma lista de MCP podada, worktrees paralelos e CI headless.

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