sprngr/rubber-duck / skills/duck-tape
duck-tape
VerifiedTwo-tier session memory: CONTEXT.md (persistent) + .duck-tape working state, with merge/dedupe. Subcommands: merge, resume, init, prune, migrate. Use when: "duck-tape", "compact session", "update CONTEXT.md", "resume session".
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 15.5 KB |
| SKILL.md | skill md | 20.7 KB |
| examples/CHANGELOG.md | markdown | 419 B |
| examples/CONTEXT.md | markdown | 2.1 KB |
| examples/STATE.md | markdown | 1.2 KB |
| examples/bootstrap-CONTEXT.md | markdown | 463 B |
| hooks/claude-code.hooks.json | config | 291 B |
| hooks/claude-code.hooks.windows.json | config | 312 B |
| hooks/copilot.hooks.json | config | 325 B |
| hooks/extract-raw.ps1 | script | 15.2 KB |
| hooks/extract-raw.shexecutable | script | 12.2 KB |
| hooks/extract-state.ps1 | script | 15.1 KB |
| hooks/extract-state.shexecutable | script | 11.3 KB |
| hooks/opencode.plugin.js | script | 12.9 KB |
| hooks/pre-compact.ps1 | script | 1.1 KB |
| hooks/pre-compact.shexecutable | script | 1.0 KB |
| references/GUARDRAILS.md | markdown | 757 B |
| references/HOOKS_GUIDE.md | markdown | 11.3 KB |
| references/OUTPUT_SCHEMA.md | markdown | 3.8 KB |
| references/SCHEMA.md | markdown | 7.0 KB |
| references/STATE_SCHEMA.md | markdown | 5.7 KB |
references/OUTPUT_SCHEMA.md
View on GitHub# Output Schema
Strict output specifications for duck-tape artifacts.
## CONTEXT.md Output Rules
### Section headers
- If emitting a section header, use exactly `## <Section>` (two hash marks, space, section name)
- Section names are case-sensitive: `Goals`, `Decisions`, `Conventions`, `Glossary`, `Deferred-Debt`, `Open-Questions`, `Notes`
- No markdown formatting in headers (no bold, no links)
### Entry format by section
**Goals**
```markdown
## Goals
- **<name>**: <what we optimize for>
```
**Decisions**
```markdown
## Decisions
- **<name>**: <decision> (date: <YYYY-MM-DD>)
```
**Conventions**
```markdown
## Conventions
- **<name>**: <convention>
```
**Glossary**
```markdown
## Glossary
- **<term>**: <definition>
```
**Deferred-Debt**
```markdown
## Deferred-Debt
- TODO(<debt type>): <YYYY-MM-DD> <what deferred> [status: open|resolved]
- TODO(<debt type>,#<issue>): <YYYY-MM-DD> <what> [resolved: <decision>]
```
**Open-Questions**
```markdown
## Open-Questions
- <question> (date: <YYYY-MM-DD>)
```
**Notes**
```markdown
## Notes
### <YYYY-MM-DD HH:MM>
<freeform content>
```
### Blank lines
- One blank line between sections
- No trailing blank lines at end of file
- Entries within a section are contiguous (no blank lines between entries)
### Durable-context translation
- State-file output preserves session detail for recovery.
- CONTEXT.md output contains durable decisions, constraints, conventions, facts,
debt, and open questions.
- Do not copy rejected approaches, recent-change context, session-only approval
flags, or review/test/session references that only describe development.
- Preserve the underlying durable meaning when filtered content contains one.
- Keep historical rationale in ADRs or changelogs.
Accepted:
```text
State: APPROVED: use shared comment guidance - review rejected duplicated wording
CONTEXT.md: - **Comment guidance**: use shared comment guidance.
```
Rejected:
```text
CONTEXT.md: - **Comment guidance**: approved after review session 42 rejected duplicated wording.
```
## State File Output Rules
### Header format
```markdown
# Agent State
Session: <YYYY-MM-DD-HHMM> | Cwd: <absolute-path> | Repo/Branch: <repo>@<branch>
Created: <ISO-8601>
```
### Section requirements
- All sections present on first write
- Empty sections use `None` marker
- Position.Current is single line
- Position.Done is ordered list (newest last)
- Position.Remaining is ordered list (next first)
- Decision Log entries are append-only
- Established Facts are verbatim
- Re-derivation is verbatim
- Suggested Skills is optional (omit if empty)
## Changelog Output Rules
### Format
```markdown
Changelog:
- Added: <section> <key>
- Superseded: <section> <key> (<old value> -> <new value>)
- Dropped: <section> <key> (<reason>)
```
### Rules
- One line per change
- Section names match schema exactly
- Key is the bold identifier (name/term)
- Supersede shows old and new values
- Drop shows explicit reason
- No changelog if no changes (emit "No changes to CONTEXT.md")
- If session-only content is filtered without a durable replacement, report it as
`Dropped: <section> <key> (session-only development history)`.
## Rotation Rules
### State files
- Max 10 files in `.duck-tape/`
- Drop oldest by session ID (lexicographic order)
## Redaction Output Rules
### Detection output
```markdown
Redaction: detected <count> potential secret(s) in <section>.
Flagged: <type> at line <N>: <masked preview>
Action: user confirmation required before masking with <REDACTED>.
```
### Rules
- If displaying a secret, show masked preview only; do not show the full value
- Masked preview shows first 4 characters + `...`
- Reject flagged content until user confirms
- Apply `<REDACTED>` marker on confirmation
- Log redaction in changelog: "Redacted: <section> <count> secret(s)"
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 |