| name | migrate-from-claude-code |
| description | Convert an existing anthropics/claude-code-action workflow to crab'd. Use when a repo already uses claude-code-action (the @claude GitHub Action) and the user wants to move to crab'd, optionally onto a non-Anthropic model or Forgejo. |
Migrate from claude-code-action to crab'd
Convert a claude-code-action setup to crab'd, preserving behavior while moving to crab'd's
model-agnostic, multi-forge model.
1. Find the existing workflow
Locate the workflow using anthropics/claude-code-action (usually .github/workflows/*.yml). Note
its triggers, prompt / mode usage, model, allowed_tools, mcp_config, and any custom
instructions.
2. Map the concepts
| claude-code-action | crab'd |
|---|
@claude mention | /crabd mention (set trigger_phrase to keep @claude if desired) |
| model input (Claude only) | model: <provider>/<model> — any provider |
custom_instructions | prompt.instructions (global) or per-mode modes.*.instructions |
CLAUDE.md / AGENTS.md in the repo | Loaded automatically — crab'd reads them at run time (context.instruction_files, on by default). No porting needed. |
.claude/skills/ (or .agents/skills/) | Discovered automatically (context.skills, on by default) — the agent reads a matching SKILL.md on demand. |
| PR review behavior | review mode (fires on PR opened/reopened/ready_for_review, or /crabd review) |
| implement / fix an issue | implement mode |
mcp_config | mcp: servers in .crabd.yml |
max_turns / timeout | limits.max_turns (hard) / limits.timeout_minutes |
| Bedrock/Vertex Claude auth | pick the matching provider (anthropic, google-vertex, …) |
3. Write the crab'd workflow
Replace the action step with louisescher/crabd@v0. Prefer OIDC identity (permissions: id-token: write) for the canonical bot, or App credentials. Keep the same event triggers, but note review fires
on opened/reopened/ready_for_review (not every push) — re-review via /crabd review.
Start from workflows/github/crabd.yml in the crab'd repo.
4. Translate config
Create .crabd.yml: set model, move custom_instructions into prompt.instructions, port MCP
servers, and set limits. If staying on Claude, model: anthropic/claude-sonnet-5 is the closest
match. Leave the repo's CLAUDE.md/AGENTS.md and any .claude/skills in place — crab'd picks them
up automatically (see Project context), so don't copy them
into config.
5. Secrets & cleanup
- Add the provider key secret (e.g.
ANTHROPIC_API_KEY) to the repo.
- Set up identity (install the crab'd App, or App creds) — see the
add-crabd-to-repo skill.
- Remove the old
claude-code-action workflow and its now-unused secrets once crab'd works.
6. Verify
Trigger a mention and a PR; confirm crab'd reacts 👀, posts a tracking comment, and behaves like the
old setup.
