Skills

Skills são guias curados pela comunidade que codificam as melhores práticas para tecnologias, frameworks ou fluxos de trabalho específicos. Quando você instala um skill para Next.js, por exemplo, o Planu aprende os padrões preferidos do seu projeto para rotas de API, componentes e testes — e injeta esse contexto em cada spec que cria.

Como o Planu usa os skills automaticamente

• Após o init_project, o Planu detecta seu stack e sugere skills relevantes
• Antes de implementar um padrão repetível, o Planu busca skills correspondentes
• Os skills aparecem como sugestões nos critérios de aceitação das specs

Você nunca precisa pensar nos skills de forma explícita. O Planu os descobre e aplica para você.

Encontrar e instalar skills

1. Pergunte à sua IA: "Busque skills de nextjs"
   → O Planu chama skill_search("nextjs")

2. Revise os resultados e escolha um
   → O Planu mostra título, descrição e contagem de instalações

3. Peça: "Instale o skill-id XXX"
   → O Planu chama skill_install("XXX")

Simples assim — três passos conversacionais e as convenções do seu stack são carregadas em cada spec futura.

Categorias de skills populares

Skills de frameworks

Tecnologia	O que o skill codifica
Next.js	Convenções do App Router, Server Actions, padrões de rotas de API
Django	Roteamento de URLs, serializadores, middleware, padrões de ORM
Rails	Convenções MVC, Active Record, padrões Hotwire
Laravel	Eloquent, Blade, service providers, padrões de filas
FastAPI	Modelos Pydantic, injeção de dependências, padrões async
NestJS	Estrutura de módulos, decoradores, guards, interceptores

Skills de bancos de dados

Tecnologia	O que o skill codifica
Prisma	Convenções de schema, migrações, padrões de relações
SQLAlchemy	Gerenciamento de sessões ORM, migrações com alembic
Drizzle	Queries com tipagem forte, definições de schema
TypeORM	Convenções de entidades, padrão de repositórios

Padrões de autenticação

Tecnologia	O que o skill codifica
NextAuth	Estratégias de sessão, configuração de provedores, callbacks
Passport.js	Configuração de estratégias, serialização de sessão
Supabase Auth	Políticas RLS, manipulação de JWT, magic links

Padrões de testes

Tecnologia	O que o skill codifica
Vitest	Padrões de testes unitários e de integração, convenções de mocking
Pytest	Padrões de fixtures, parametrize, testes async
Jest	Mocking de módulos, convenções de snapshots, configuração de cobertura

CI/CD

Tecnologia	O que o skill codifica
GitHub Actions	Estrutura de workflows, cache, builds matriciais
GitLab CI	Estágios de pipeline, artefatos, ambientes

Design e marca

Categoria	O que o skill codifica
Geração de logos	Padrões de prompts para logos de marca consistentes
Imagens OG	Convenções de Open Graph para pré-visualizações sociais
Favicon	Fluxos de geração de favicons em múltiplas resoluções

Criar seu próprio skill

Quando seu projeto tem um padrão repetível que nenhum skill da comunidade cobre, crie um:

Peça: "Crie um skill para [seu padrão]"
→ O Planu chama create_skill com suas convenções
→ O skill é salvo em .claude/skills/ no seu projeto

Seu arquivo de skill fica em .claude/skills/ e é detectado automaticamente em cada sessão.

Publicar no registro

Quando seu skill estiver bem testado, compartilhe-o com a comunidade:

Peça: "Publique meu skill no registro do Planu"
→ O Planu chama registry_publish
→ Disponível para a comunidade

Skills publicados recebem uma contagem de instalações, uma avaliação e aparecem nos resultados de skill_search para todos os usuários do Planu.

Skills vs Rules vs Hooks

	Skills	Rules	Hooks
Propósito	Melhores práticas por tecnologia	Restrições sempre ativas	Automação por eventos
Escopo	Por projeto	Global ou por projeto	Global ou por projeto
Gerenciado por	Comunidade + você	Você	Você
Aplicado quando	Uma spec é criada	Cada interação com a IA	Em eventos de git

Use Skills para ensinar ao Planu as convenções do seu stack. Use Rules para aplicar políticas inegociáveis. Use Hooks para automatizar ações repetitivas acionadas por eventos de git como commits e pushes.