Skip to content

feat: multi-agent skill packaging — 30+ agent CLIs via caveman installer pattern#18

Merged
derek-palmer merged 2 commits into
mainfrom
feat/multi-agent-skills
May 24, 2026
Merged

feat: multi-agent skill packaging — 30+ agent CLIs via caveman installer pattern#18
derek-palmer merged 2 commits into
mainfrom
feat/multi-agent-skills

Conversation

@derek-palmer
Copy link
Copy Markdown
Owner

@derek-palmer derek-palmer commented May 24, 2026

Summary

Packages forerunner's prompt tasks as native slash commands for agent CLIs. Users with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and 28 other supported agents can use forerunner with zero API key configuration — authentication flows through their existing subscription.

12 new per-task skills (each becomes a slash command):
`/forerunner-scan` · `/forerunner-readme` · `/forerunner-api-docs` · `/forerunner-audit` · `/forerunner-changelog` · `/forerunner-check` · `/forerunner-diagrams` · `/forerunner-flows` · `/forerunner-init` · `/forerunner-review` · `/forerunner-stack-docs` · `/forerunner-version-audit`

Installer (rewritten to match caveman's full pattern):

  • bin/install.js — real installer, 33-agent matrix with detection probes
  • install.sh / install.ps1 — thin shims that exec node bin/install.js locally or npx github:derek-palmer/codeforerunner for curl|bash
  • Detection probes: command:, macapp:, vscode-ext:, cursor-ext:, jetbrains-plugin:, dir:, file: (||‑delimited, bash-3.2 safe)
  • Install mechanisms: claude plugin install, gemini extensions install, npx skills add -a <profile> --yes --all
  • Flags: --dry-run, --force, --only (repeatable), --all, --minimal, --list, --no-color, --skip-skills, --uninstall
  • Colored summary: ✓ installed / – skipped / ✗ failed
  • skills-lock.json — SHA-256 hashes for all 13 skill files

33 supported agents (4 soft): claude, gemini, opencode, codex, cursor, windsurf, cline, continue, kilo, roo, augment, copilot (soft), aider-desk, amp, bob, crush, devin, droid, forgecode, goose, iflow, kiro, mistral, openhands, qwen, rovodev, tabnine, trae, warp, replit, junie (soft), qoder (soft), antigravity (soft)

Agent directories added:

  • .codex/config.toml — Codex skills autodiscovery
  • GEMINI.md — Gemini CLI autodiscovery
  • plugins/codeforerunner/skills/<slug>/SKILL.md — 13 distributed skill copies
  • skills/<slug>/SKILL.md — 13 canonical skill sources

Test plan

  • node bin/install.js --list shows 33 agents with correct detection
  • node bin/install.js --dry-run prints what-would-run without writing files
  • ./install.sh --list delegates to bin/install.js
  • ./install.sh --dry-run --only claude dry-runs claude plugin install
  • forerunner install --all claude installs all 13 skills to ~/.claude/plugins/codeforerunner/skills/
  • All 187 existing tests pass

🤖 Generated with Claude Code

Each forerunner task becomes a native slash command for Claude Code,
Codex, and Gemini CLI. Authentication flows through the user's existing
agent subscription; no API key required.

New skills (skills/ → plugins/codeforerunner/skills/):
  /forerunner-scan      /forerunner-readme     /forerunner-api-docs
  /forerunner-audit     /forerunner-changelog  /forerunner-check
  /forerunner-diagrams  /forerunner-flows      /forerunner-init
  /forerunner-review    /forerunner-stack-docs /forerunner-version-audit

New files:
  install.sh / install.ps1  — detect claude/codex/gemini, install all
                              skills; --dry-run, --only, --list, --uninstall
  GEMINI.md                 — Gemini CLI autodiscovery + task table
  .codex/config.toml        — Codex skills integration flag
  .claude-plugin/marketplace.json — Claude Code marketplace entry

installer.py: TASK_SKILL_SLUGS tuple, resolve_skill_target(),
  install_all_skills(), --all flag on `forerunner install`

README: restructured around two modes (agent skill vs direct API),
  slash-command table, install one-liners, curl|bash instructions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 24, 2026

Warning

Review limit reached

@derek-palmer, we couldn't start this review because you've used your available PR reviews for now.

Your plan includes 1 review of capacity. Refill in 8 minutes and 22 seconds.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more review capacity refills, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than trial, open-source, and free plans. In all cases, review capacity refills continuously over time.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 01e71350-d3c9-448a-96da-dd0887473b8b

📥 Commits

Reviewing files that changed from the base of the PR and between d5cd12c and 7e904a1.

📒 Files selected for processing (34)
  • .claude-plugin/marketplace.json
  • .codex/config.toml
  • GEMINI.md
  • README.md
  • bin/install.js
  • bin/package.json
  • install.ps1
  • install.sh
  • plugins/codeforerunner/skills/forerunner-api-docs/SKILL.md
  • plugins/codeforerunner/skills/forerunner-audit/SKILL.md
  • plugins/codeforerunner/skills/forerunner-changelog/SKILL.md
  • plugins/codeforerunner/skills/forerunner-check/SKILL.md
  • plugins/codeforerunner/skills/forerunner-diagrams/SKILL.md
  • plugins/codeforerunner/skills/forerunner-flows/SKILL.md
  • plugins/codeforerunner/skills/forerunner-init/SKILL.md
  • plugins/codeforerunner/skills/forerunner-readme/SKILL.md
  • plugins/codeforerunner/skills/forerunner-review/SKILL.md
  • plugins/codeforerunner/skills/forerunner-scan/SKILL.md
  • plugins/codeforerunner/skills/forerunner-stack-docs/SKILL.md
  • plugins/codeforerunner/skills/forerunner-version-audit/SKILL.md
  • skills-lock.json
  • skills/forerunner-api-docs/SKILL.md
  • skills/forerunner-audit/SKILL.md
  • skills/forerunner-changelog/SKILL.md
  • skills/forerunner-check/SKILL.md
  • skills/forerunner-diagrams/SKILL.md
  • skills/forerunner-flows/SKILL.md
  • skills/forerunner-init/SKILL.md
  • skills/forerunner-readme/SKILL.md
  • skills/forerunner-review/SKILL.md
  • skills/forerunner-scan/SKILL.md
  • skills/forerunner-stack-docs/SKILL.md
  • skills/forerunner-version-audit/SKILL.md
  • src/codeforerunner/installer.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/multi-agent-skills
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch feat/multi-agent-skills

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Replace the hand-rolled bash/PowerShell installers with a thin
Node.js shim model: install.sh and install.ps1 now just exec
`node bin/install.js` locally (or `npx github:<repo>` for curl|bash).
The real installer lives in bin/install.js and supports 33 agent CLIs
with the same detection probes and install mechanisms as caveman:

- Full PROVIDERS matrix (33 agents, 4 soft): claude, gemini, opencode,
  codex, cursor, windsurf, cline, continue, kilo, roo, augment,
  copilot, aider-desk, amp, bob, crush, devin, droid, forgecode, goose,
  iflow, kiro, mistral, openhands, qwen, rovodev, tabnine, trae, warp,
  replit, junie, qoder, antigravity
- Detection probes: command:, dir:, file:, macapp:, vscode-ext:,
  cursor-ext:, jetbrains-plugin: (||‑delimited, bash-3.2 safe)
- Install mechanisms: `claude plugin install`, `gemini extensions install`,
  `npx skills add <repo> -a <profile> --yes --all`
- Flags: --dry-run, --force, --only (repeatable), --all, --minimal,
  --list, --no-color, --skip-skills, --uninstall, -h/--help
- Colored summary matching caveman's ✓/–/✗ format
- skills-lock.json with SHA-256 hashes for all 13 skill files
- bin/package.json { "type": "commonjs" }

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@derek-palmer derek-palmer changed the title feat: multi-agent skill packaging — 12 slash commands for Claude Code, Codex, Gemini CLI feat: multi-agent skill packaging — 30+ agent CLIs via caveman installer pattern May 24, 2026
@derek-palmer derek-palmer merged commit 0e51dd5 into main May 24, 2026
3 checks passed
@derek-palmer derek-palmer deleted the feat/multi-agent-skills branch May 24, 2026 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant