rubber-duck skill

SkillFiles & storage

Invoke the rubber duck reviewer for a second opinion. Use after planning, after complex multi-file implementations, or after writing tests. Produces a focused CRITICAL/WARN/INFO list and a APPROVE/REQUEST_CHANGES verdict.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the rubber-duck skill skill

What this skill tells your AI

The instructions your AI receives, as published by kinncj/heimdall in .claude/skills/rubber-duck/SKILL.md and read by ahel’s review.

Invoke @rubber-duck to get an independent second opinion on a plan, implementation, or test suite. This is the same pattern as GitHub Copilot CLI's built-in Rubber Duck feature — a different perspective to catch what the primary agent missed.

When to invoke

CheckpointWhat to passWhat you get back
After Phase 3 (plan complete)plan.md + test-plan.mdPLAN REVIEW
After complex multi-file implementationChanged files / diffCODE REVIEW
After tests written, before runningTest filesTEST REVIEW
Any time you feel uncertainAnything relevantFocused critique

How to call it

@rubber-duck Mode: PLAN REVIEW

Plan: <paste plan.md content or path>
Story: <paste story frontmatter + scenarios>
@rubber-duck Mode: CODE REVIEW

Files changed:
- src/scheduler.ts
- src/jobs/notify.ts
- src/queue/index.ts

<paste diff or file content>
@rubber-duck Mode: TEST REVIEW

Test files:
- tests/unit/scheduler.test.ts
- tests/e2e/notify.spec.ts
- features/scheduler.feature

<paste test content>

Verdict handling

VerdictOrchestrator action
APPROVEProceed to next phase
REQUEST_CHANGESSend findings to the responsible agent for revision; re-review once

CRITICAL findings always block. WARN findings are surfaced to the human for a decision. INFO findings are logged but do not block.

Tips

  • You do not need to prepare anything special — just pass the relevant content.
  • The rubber duck will not rewrite your code. It only surfaces findings. Acting on them is your job.
  • For Copilot CLI users: the built-in /experimental Rubber Duck activates automatically at the same checkpoints. This skill adds equivalent coverage when using Claude Code or OpenCode.

Signals

GitHub stars
66
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
rubber-duck-kinncj
Source
github.com/kinncj/heimdall