convez.ai
SkillAutomaçãoIntermediário
AirMile

Claude Config

AirMile/claude-config

Setup modular de skills e agents para Claude Code com bootstrapping automático

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema pessoal e versionado de configuração do Claude Code com skills, agents, hooks e scaffolding de projetos. Organiza-se via symlinks/junctions em ~/.claude/, permitindo invocar skills como /skill-name e delegar tarefas a sub-agents isolados.

Instalação

$npx convez-ai AirMile/claude-config

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Configurar e manter ambiente Claude Code consistente entre máquinas
  • Orquestrar workflows de desenvolvimento com skills reutilizáveis
  • Automatizar setup de projetos (greenfield ou existentes) com detecção inteligente

Veredito

Projeto maduro e bem-documentado para quem quer transformar Claude Code em ferramenta de desenvolvimento profissional. A arquitetura modular de skills e o bootstrapping automático reduzem fricção operacional, mas exigem familiaridade com CLI e estrutura de projetos.

README

A tradução para o português deste README ainda está na fila.

claude-config

改善 (Kaizen) — Good enough today, better tomorrow.

A personal, versioned Claude Code setup — skills, hooks, and project scaffolding linked into ~/.claude/ via symlinks (macOS) or junctions (Windows). Skills run as /skill-name; a few delegate to isolated sub-agents under the hood.

~/.claude/skills/   →  junction/symlink to this repo's skills/
~/.claude/agents/   →  junction/symlink to this repo's agents/
~/.claude/hooks/    →  junction/symlink to this repo's hooks/
~/.claude/scripts/  →  junction/symlink to this repo's scripts/

Quickstart

1. Clone the repo:

git clone https://github.com/<your-username>/claude-config.git
cd claude-config

2. Bootstrap once per machine (inside Claude Code):

/core-bootstrap

Deploys CLAUDE.md, settings.json, keybindings.json, statusline + 4 global symlinks (~/.claude/{skills,agents,hooks,scripts}).

3. Per project, pick one entry point:

SituationRun
Already inside an existing project directory/core-setup — auto-detects greenfield vs. mature
Creating or cloning a fresh project/project-add from anywhere — then hands off to /core-setup

/core-setup is re-invokable: audit (checklist), resync (refresh CLAUDE.md), install <module> (tailwind / vitest / playwright / shadcn-ui / biome / …).

4. Stay up to date:

/core-update

Pulls the latest claude-config and rebuilds composed global files. For setup without Claude Code, see local/README.md. Release notes per version: CHANGELOG.md.

Recommended Claude Code settings

/model opusplan + "effortLevel": "high" in ~/.claude/settings.json. claude-config is built around this setup for token efficiency — Opus plans, Sonnet executes — not full-Opus runs. /core-bootstrap asks for your Claude plan and tunes the advice: the defaults are calibrated for Max 5x; Pro / Max 10x get different guidance.

Skills & pipelines

Skills follow a {category}-{verb} naming convention. See skills/shared/SKILL-PATTERNS.md for conventions and skills/shared/PIPELINE.md for canonical pipeline diagrams.

CategorySkills
coreaudit, bootstrap, commit, create, delete, edit, merge, pull, rewrite, setup, update, write
devbuild, debug, define, learn, optimize, owasp, refactor, verify
frontendcheck, design, tokens
gamebuild, debug, define, optimize, refactor, verify
marketingcontent, research, screenshots
projectadd, backlog, brainstorm, critique, remove, research, seed, switch, todo, tunnel, viewer
teamissues, outsource, review, verify
PipelineFlow
devproject-seed → [project-brainstorm] → [project-critique] → project-backlog → define → build → verify → [refactor] (+ debug anywhere)
gameproject-seed → project-backlog → define → build → verify → [refactor] (+ debug anywhere, Godot 4.x / GUT)
frontend[/frontend-tokens] (incl. motion packs) → frontend-design (design/build/convert) → frontend-check
marketingmarketing-research → marketing-content → marketing-screenshots

Optional /project-research enriches the dev seed with market/tech/codebase context before backlog.

State handoff between skills lives in .project/session/devinfo.json (schema: shared/DEVINFO.md). A handful of skills delegate parallel work to sub-agents in agents/ (OWASP scanners, Godot researchers, fix-strategies, learning-extractor) — invisible to the user.

Runtime state — backlog, dashboard, learnings

All runtime artifacts live in a gitignored .project/ directory per project:

ArtifactPathPurpose
Backlog.project/backlog.htmlStatus flow: TODO → DEFINED → DOING → DONE → shipped
Dashboard.project/project.jsonContext, features, stack, endpoints, entities (schema: shared/DASHBOARD.md)
Learnings.project/project-context.json#learnings[]Pull-based memory — Auto Memory deliberately disabled for token efficiency. Build/refactor skills append; consumers load via shared/LEARNINGS-LOAD.md with scope (component / architectural / pitfall-prefix)

Run /project-viewer to serve all project backlogs and dashboards on http://localhost:9876 — one local board across every project under {projects_root}. Stop with /project-viewer stop.

Inspect overlay

A dev-only visual element-picker: click any element in the browser to copy a bracketed reference like [src/components/Button.tsx:42], then paste it into Claude. Cuts the "find this component" round-trip out of frontend iteration. Works on Vite + React, Next.js, and plain JS / static HTML (any DOM).

Install (per project):

/core-setup install inspect-overlay

Adds the overlay files to your project root and .gitignore, wires up the plugin, and restarts the dev server.

Use — keyboard-driven, no on-screen toggle:

ActionResult
Cmd+Shift+X (macOS) / Ctrl+Shift+XToggle inspect mode on/off
HoverHighlights the element under your cursor
ClickCopies [src/components/Button.tsx:42] to clipboard
Shift+ClickPin multiple elements (copies all refs together)
DragSelect a region — copies refs for everything inside
Ctrl+ZUnpin the last selected element
EscapeClear pins / exit inspect mode

Paste the ref into Claude as context — no more "where is that button defined?"

Modes — Full = Babel injects data-inspector-* attrs → exact file:line refs; Degraded = no attrs → DOM-based refs (tag + class + visible text):

StackMode availableSample clipboard output
Vite + ReactFull / Degraded[src/components/Button.tsx:42:3]
Next.js + ReactFull / Degraded[src/components/Button.tsx:42]
Plain JS / static HTML / no ReactDegraded only[button.btn.btn-primary "Save changes"]

Full mode trades faster builds (Turbopack on Next.js, OXC on Vite v6) for exact refs — /core-setup install inspect-overlay defaults to Full on Vite (pins plugin-react@^5) and asks on Next.js. Plain JS gets a one-shot script-tag install, always degraded. Details: skills/core-setup/references/modules/inspect-overlay/setup-guide.md.

Teardown: /core-setup does not remove modules automatically — ask explicitly ("remove the inspect overlay") and it walks back the install steps.

Personal overlay

Keep personal customisations (language preference, writing styles, opinionated defaults) separate from the public repo:

personal/                    ← gitignored, never committed
  CLAUDE.md.overlay          ← appended to ~/.claude/CLAUDE.md after base
  settings.overlay.json      ← deep-merged into settings.json (your values win)
  styles/                    ← writing styles for core-write / core-rewrite

Setup is manual — /core-bootstrap only applies overlays, it doesn't create them. Bootstrap your personal/ folder once:

mkdir -p personal/styles
touch personal/CLAUDE.md.overlay personal/settings.overlay.json
# Then edit the two files with your additions, or copy from the template:
cp personal/README.md.template personal/README.md

The next /core-bootstrap (or /core-update) auto-detects the folder and merges it in. Survives git pull safely.

Multi-device sync: iCloud / OneDrive / Dropbox folder + symlink into personal/, a private GitHub repo cloned into personal/, or manual copy.

Cross-platform & prerequisites

Cross-platform: macOS and Windows. Skills use {projects_root} instead of hardcoded paths; paths.yaml holds per-platform defaults, overrideable via env vars or paths.local.yaml.

ToolVersionRequired for
Node.js18+Hooks (format-on-save, prompt-timer), backlog server
Python 33.8+Security-reminder hook
gitanyVersion control
gh CLIanyTeam skills (team-review, team-issues) — optional
jqanyPersonal overlay settings merge — optional
skills/           Slash commands, organized by category
  shared/         Shared references and patterns — read-only single source of truth
  {cat}-{verb}/   Each skill: SKILL.md + optional references/, scripts/, techniques/
agents/           Sub-agent definitions (markdown with YAML frontmatter)
hooks/            PostToolUse / PreToolUse / UserPromptSubmit hooks
local/            Portable configs for ~/.claude/ — copied by bootstrap, not symlinked
personal/         Personal overlay — gitignored, never committed
CLAUDE.base.md    Template for per-project CLAUDE.md generation

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados