sprngr/rubber-duck / skills/quack
quack
VerifiedExplicit user-invoked routing for Rubber Duck workflows. Use when: "quack", "quack <intent>".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.1 KB |
| assets/heartbeat.md | markdown | 1.5 KB |
| assets/quick-help.md | markdown | 1.4 KB |
| assets/route-aliases.json | config | 2.3 KB |
| assets/subagent-runbook.md | markdown | 5.7 KB |
| references/Examples.md | markdown | 2.6 KB |
| references/GUARDRAILS.md | markdown | 757 B |
references/Examples.md
View on GitHub# Quack UX Micro-Spec
Goal: make `quack` feel like intent routing, not command syntax.
## Interaction Contract
1. Bare `quack`
- show compact quick-help only
- no clarifying question unless user adds task text
1. Resolvable intent
- emit one-line confirmation
- `Routing: <skill>.`
- include `via <subagent>` only when user explicitly overrides subagent
- execute immediately (inline or delegated per policy)
1. Unresolvable intent
- ask one targeted disambiguation question
- use compact prompt form: `Need one detail: <question>`
- no route menu
1. Subagent override
- accept `use|with|via <subagent>`
- if valid, override default routing
- if invalid, ask one correction question
## Response Patterns
Success (alias):
- `Routing: duck-review.`
Success (explicit skill):
- `Routing: duck-review.`
Success (override):
- `Routing: duck-review via general.`
Miss:
- `Need one detail: did you mean review, risk, or trace?`
Invalid override:
- `Need one detail: unknown subagent "<x>". Use duckling or general?`
## Route Priority Hints
- diff / PR / changed files -> bias `duck-review`
- stack trace / call path / "where used" -> bias `duck-debug` (trace mode)
- rollout / migration / compatibility / rollback -> bias `duck-risk`
- "overengineered" / "too complex" -> bias `duck-simplify`
- "duplicate" / "drift" -> bias `duck-simplify`
- "fix/edit/patch" -> bias `duck-patch`
## Skill Composition Examples
Multi-skill workflows using natural language chaining:
**Debug -> Patch**:
```
User: quack debug this endpoint failure then patch it
Expected: Routes to duck-debug first, then suggests duck-patch after root cause identified
```
**Review -> Risk -> Simplify** (comprehensive review):
```
User: quack review this refactor for correctness, risk, and complexity
Expected: Routes to duck-review with note to follow up with duck-risk and duck-simplify
```
**Design -> Triage**:
```
User: quack design this migration and suggest test scenarios
Expected: Routes to duck-design, then suggests duck-triage for test planning
```
**Teach -> Debug**:
```
User: quack explain this auth flow then help debug the token expiry
Expected: Routes to duck-teach first, then duck-debug for investigation
```
**Notes:**
- Composition is user-initiated (not enforced)
- Quack routes to first skill, suggests next steps
- User maintains control of when to proceed to next skill
- Each skill can be invoked independently
## UX Guardrails
- don’t restate policy unless needed
- don’t explain routing internals unless asked
- don’t ask more than one question on alias miss
- don’t block execution after successful route resolution
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |