Claude Config

Pacote npm com skills e agents compartilhados entre projetos Claude Code.

Uso

No projeto consumidor, rode:

npm i -D otavio-claude-config

Durante a instalacao, o pacote tenta detectar o profile pelo projeto. Exemplo:

• expo ou react-native -> mobile
• vite ou React com vite.config.ts -> react-vite

Se o projeto ja tiver claudeConfig.profile, ele usa o profile salvo.

Entao o pacote:

• adiciona o script claude:install
• grava claudeConfig.profile
• instala as skills e agents em .claude/skills e .claude/agents

Quando rodar npm i -D otavio-claude-config de novo, ele usa o profile salvo e atualiza a .claude.

Depois da primeira instalacao, voce tambem pode atualizar manualmente com:

npm run claude:install

Escolher profile manualmente

Se o profile nao for detectado automaticamente, rode:

npx claude-config setup

Ou sem pergunta:

npx claude-config setup --profile mobile

Estrutura

otavio-claude-config/
├── bin/
│   ├── claude-config.js  # CLI do pacote
│   └── postinstall.js    # Setup automatico apos npm install
├── config/
│   ├── skills/           # Skills organizadas por stack/produto
│   ├── agents/           # Agents organizados por stack/produto
│   └── profiles/         # Define quais skills/agents cada tipo de projeto usa
├── personal/             # Backup de configuracoes pessoais
└── package.json

Resultado no projeto

O package.json do projeto fica parecido com:

{
  "devDependencies": {
    "otavio-claude-config": "^1.0.0"
  },
  "scripts": {
    "claude:install": "npm exec --yes --package otavio-claude-config -- claude-config install"
  },
  "claudeConfig": {
    "profile": "mobile"
  }
}

Criar nova skill ou agent

1. Criar a skill em config/skills/<stack-ou-produto>/<nome>/SKILL.md.
2. Criar o agent em config/agents/<stack-ou-produto>/<nome>.md.
3. Adicionar o grupo ao profile em config/profiles/<profile>.json, se necessario.
4. Fazer push na main; o GitHub Actions publica uma nova versao patch no npm.

Publicacao npm

O workflow .github/workflows/publish-npm.yml publica automaticamente no npm quando bin/, config/, package.json ou README.md mudam na main.

Antes de usar o CI, crie no GitHub o secret:

NPM_TOKEN

Esse token precisa ter permissao de publicar o pacote otavio-claude-config.

Profiles disponiveis

• react-vite - React + Vite + TypeScript + Tailwind
• kotlin-spring - Kotlin + Spring Boot
• java-spring - Java + Spring Boot
• mobile - React Native + Expo
• fluig - TOTVS Fluig