rubber-duck

Narrate decisions and rationale in real time via Rubber Duck mode.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/mcevoyinit/agentic-skills --skill rubber-duck-mcevoyinit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rubber-duck
Source: https://github.com/mcevoyinit/agentic-skills/tree/main/skills/coding-modes/rubber-duck
Command: npx skills add https://github.com/mcevoyinit/agentic-skills --skill rubber-duck-mcevoyinit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables AI agents to articulate every decision, assumption, and rationale in real time, increasing transparency, traceability, and error detection during complex tasks.

Core Features & Use Cases

  • Always narrate: expose decisions, assumptions, tradeoffs, uncertainties, and discoveries to reduce guesswork and mistakes.
  • Guided reasoning: structure your thinking to catch errors early in debugging, coding, and planning.
  • Use cases: ideal for code reviews, architectural planning, and strategy sessions where rationale matters.

Quick Start

Enable Rubber Duck mode and start narrating every decision and assumption before acting.

Frequently Asked Questions about rubber-duck

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does narrating reasoning improve debugging and decision-making accuracy?

Narrating reasoning exposes assumptions, tradeoffs, and uncertainties in real time, reducing guesswork and catching errors early during debugging. Structured, transparent thinking improves accuracy and auditability for complex coding and planning tasks.

What is the best way to make my AI agent's decision-making process transparent?

The best way to make decision-making transparent is enabling Rubber Duck mode to articulate every decision, assumption, and rationale before acting. This real-time narration increases traceability and error detection during complex tasks.

How do I start narrating decisions and assumptions for code reviews?

To start narrating decisions for code reviews, enable Rubber Duck mode and adhere to the narration protocol by explicitly stating every assumption and rationale before taking action. This exposes tradeoffs and reduces mistakes.

Can I use narrated reasoning for architectural planning without external tooling?

Yes, you can use narrated reasoning for architectural planning without external tooling. The built-in Rubber Duck mode requires no dependencies, allowing you to structure thinking and expose discoveries during strategy sessions.

When should I not use transparent reasoning narration for my coding tasks?

Transparent reasoning narration might not suit highly routine or trivial coding tasks where exhaustive explanation of assumptions creates unnecessary friction, as its primary value lies in catching errors during complex debugging and design reviews.

Why does the rubber-duck approach help with strategic planning and design reviews?

The rubber-duck approach helps with strategic planning and design reviews by forcing real-time articulation of rationale and uncertainties, which reduces errors and ensures the decision-making process is fully auditable.