| name | gentle-ai |
| description | Trigger: gentle-ai, configurar agentes, ecosystem doctor, actualizar gentle-ai, sdd status, sdd continue, gga review, skill-registry. Drive the Gentle-AI ecosystem CLI from Claude Code. Skip: running SDD phases (use sdd-* skills). |
| author | Gonzalo Astudillo |
| version | 1.0.0 |
| date | "2026-06-29T00:00:00.000Z" |
| user-invocable | true |
Gentle-AI — Ecosystem CLI Wrapper
Thin operational wrapper over the gentle-ai and gga binaries: health checks, syncing managed configs, upgrades, SDD status, and code review. The SDD phases themselves run via the sdd-* skills/agents — this skill only surfaces the ecosystem commands.
The Iron Law
gentle-ai install / uninstall rewrite ~/.claude. NEVER run either without explicit user confirmation, and ALWAYS back up first, then preview with --dry-run:
tar -czf ~/.claude-backup-$(date +%Y%m%d-%H%M%S).tar.gz -C ~ --exclude='.claude/projects' .claude
cp ~/.claude.json ~/.claude.json.backup-$(date +%Y%m%d-%H%M%S)
gentle-ai install --agent claude-code --scope global --dry-run
Hard Rules
- Read-only first: prefer
doctor, --dry-run, version, update (check) over mutating commands.
gentle-ai upgrade applies updates to managed tools — run update first to show what changes.gga writes git hooks per-repo — run from the target repo, confirm before gga install.- The
gonaas/skills repo stays the source of truth for ~/.claude/skills. After any gentle-ai change that adds skills, flag the divergence so it can be folded into the repo.
Decision Gates
| Intent | Command |
|---|
| "is my setup healthy" | gentle-ai doctor |
| "are there updates" | gentle-ai update (check), then gentle-ai upgrade (confirm) |
| "sync configs to latest" | gentle-ai sync |
| "refresh skill index" | gentle-ai skill-registry refresh |
| "SDD status / what phase" | gentle-ai sdd-status [change] |
| "next SDD phase" | gentle-ai sdd-continue [change] |
| "review my staged code" | gga run (from target repo) |
| "configure / reinstall agent" | Iron Law ↑ — backup, --dry-run, confirm, then gentle-ai install |
| "restore a config backup" | gentle-ai restore |
Execution
- Map intent → command via the table.
- For mutating commands (
install, uninstall, upgrade, gga install): back up, run --dry-run where supported, show the plan, get confirmation, then execute.
- Run the command; capture output.
Output Contract
Report the command run, key result lines (doctor pass/fail summary, version delta, files changed), and any divergence from the gonaas/skills repo that should be reconciled.
References
gentle-ai --help, gentle-ai install --help, gga --help- Gentleman-Programming/gentle-ai README
