Skip to content

sprngr/rubber-duck / skills/quack

Explicit user-invoked routing for Rubber Duck workflows. Use when: "quack", "quack <intent>".

FileKindSize
SKILL.mdskill md5.1 KB
assets/heartbeat.mdmarkdown1.5 KB
assets/quick-help.mdmarkdown1.4 KB
assets/route-aliases.jsonconfig2.3 KB
assets/subagent-runbook.mdmarkdown5.7 KB
references/Examples.mdmarkdown2.6 KB
references/GUARDRAILS.mdmarkdown757 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
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall