convez.ai
SkillAutomaçãoIntermediário
linder3hs

setup-ai

linder3hs/setup-ai

Marketplace de agents e skills para Claude Code com instalação centralizada

Ver no GitHub
InicialPluginScore · de 0 a 100

Harness reutilizável para Claude Code que centraliza agents, skills e slash commands em um único repositório, instalável em qualquer projeto via symlinks. Permite sincronizar atualizações instantaneamente em múltiplos projetos com um único git pull, incluindo templates stack-aware e hooks opcionais.

Instalação

$npx convez-ai linder3hs/setup-ai

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
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Padronizar workflows de code review e testes entre múltiplos projetos
  • Centralizar prompts de planejamento, auditoria de segurança e geração de testes
  • Atualizar ferramentas de IA em todos os projetos simultaneamente via symlinks

Veredito

Solução pragmática para times que usam Claude Code regularmente, eliminando duplicação de agents e skills. O uso de symlinks é elegante, mas requer disciplina — a CLI é clara, mas o setup inicial pode ser opaco para iniciantes.

README

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

setup-ai

A reusable AI coding harness for Claude Code. One source of truth for your agents, skills, slash commands, hooks and CLAUDE.md templates — installed into any project with one command, updated everywhere with a single git pull.

Built for a Next.js 16 / React 19 / TypeScript + Node/Fastify workflow, but works in any repo.

What you get

TypeItems
Slash commands/plan · /review · /test · /scaffold
Subagentsplanner · code-reviewer · security-reviewer · test-engineer · scaffolder
Skillsplan-feature · review-diff · security-audit · write-tests · qa-browser · scaffold-project
Hooks (opt-in)auto-format on save (prettier) · guard against rm -rf / force-push / DROP TABLE
Templatesstack-aware CLAUDE.md (Next.js / Node / generic)
Stack refsstacks/nextjs-react.md, stacks/node-fastify.md (loaded on demand)

Install the CLI (once per machine)

bash install.sh        # links bin/setup-ai → ~/.local/bin/setup-ai
# ensure ~/.local/bin is on PATH

Use it in a project

cd ~/dev/my-app
setup-ai install              # symlinks the harness into ./.claude/ + drops a CLAUDE.md
setup-ai install --with-hooks # also enable format + guard hooks

Then open Claude Code in that project — /help lists the commands, /agents lists the subagents.

How it works

setup-ai install symlinks each file from core/{agents,skills,commands} into the project's .claude/. Because they're symlinks, editing a skill here updates every project instantly — no reinstall. A .claude/.setup-ai-manifest.json records exactly what was installed for clean updates and removal. Your project's own .claude/ files are never overwritten.

Commands

setup-ai install [path] [--with-hooks] [--force]   install into a project (default: cwd)
setup-ai update  [path]                             sync new files, prune dead links
setup-ai list    [path]                             show what's installed
setup-ai uninstall [path]                           remove only setup-ai's files
setup-ai doctor  [path]                             check for broken links / version drift
setup-ai version

Updating the harness

cd ~/dev/setup-ai && git pull   # symlinked projects pick up changes immediately
setup-ai update                 # in a project, only if files were added/removed

Layout

core/agents/    core/skills/<name>/SKILL.md    core/commands/   ← the harness (symlinked in)
hooks/hooks.json        templates/CLAUDE.*.md        stacks/*.md
bin/setup-ai            install.sh
.claude-plugin/marketplace.json + core/.claude-plugin/plugin.json  ← optional: install as a plugin

Bonus: install as a plugin instead

The repo is also a published Claude Code plugin marketplace. From any project, in Claude Code:

/plugin marketplace add linder3hs/setup-ai
/plugin install setup-ai@setup-ai

(Or point at a local checkout instead of GitHub: /plugin marketplace add ~/dev/setup-ai.)

This namespaces the commands (/setup-ai:plan) and skips the symlink installer — useful for sharing with a team. The setup-ai CLI remains the simpler path for solo, always-latest use.

Extending

Add a new skill: create core/skills/<name>/SKILL.md with a description frontmatter. Add an agent: drop core/agents/<name>.md. Add a command: core/commands/<name>.md. Run setup-ai update in your projects (or just git pull — symlinks already point at the new files once you re-run install/update to link the new paths).

Ver o original no GitHub

Bom para

Relacionados