scratchpad
Skill1 starsChanged 3 days agoMITView on GitHub
Compaction-resilient session notepad. Save working context that survives long conversations. Three tiers — pinned (always loaded), working (session), manual (permanent).
7 other projects use a version of this.
Adopted by
Most recently taken up by
- 5uck1ess/devkittheir own version, first seen Nov 15, 2026
- LucasCooperBey/claude-skillsword for word, first seen Oct 20, 2026
- anis-dr/skillstheir own version, first seen Oct 15, 2026
- dovoanhtruong/abap-agent-claudecode-workspacetheir own version, first seen Oct 12, 2026
- opelpleple/meta-skillstheir own version, first seen Oct 11, 2026
- Effect-TS/effect-smoltheir own version, first seen Oct 8, 2026
Other versions7 projects use a version of this.
Word for word · 1
- LucasCooperBey/claude-skills★ 1100% same
Edited · 0
None found.
Wrote their own version · 6
- Effect-TS/effect-smol★ 782same name
- 5uck1ess/devkit★ 4same name
- anis-dr/skills★ 4same name
- dovoanhtruong/abap-agent-claudecode-workspace★ 3same name
- couimet/my-claude-skills★ 1same name
- opelpleple/meta-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository53 other files it gives its agents.
- AGENTS.mdAGENTS.md
- skills/deep-recon/agents.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adversarial-researchSkill
- algorithmic-artSkill
- api-integrationSkill
- breakdownSkill
- c4-architectSkill
- canvas-designSkill
- coding-agentsSkill
- compound-engineeringSkill
- context-budgetSkill
- counterfactualSkill
- critiqueSkill
- d3js-visualizationSkill
- data-analyst-agentSkill
- database-migrationsSkill
- deep-reconSkill
- design-tasteSkill
- e2b-sandboxSkill
- ecosystem-auditSkill
- executing-plansSkill
- frontend-designSkill
- fullstack-agentSkill
- grillSkill
- kickoffSkill
- mcp-builderSkill
- model-migrationSkill
- naming-the-machineSkill
- full-output-enforcementSkill
- package-researchSkill
- pdf-generationSkill
- pp2pSkill
- pp3pSkill
- prompt-engineerSkill
- prompt-groundingSkill
- redesignSkill
- requesting-code-reviewSkill
- reverse-engineer-to-learnSkill
- review-changesSkill
- shipSkill
- slack-gif-creatorSkill
- sprint-architectSkill
- techdebtSkill
- test-and-fixSkill
- threat-modelSkill
- verification-before-completionSkill
- visual-verdictSkill
- webapp-testingSkill
- web-asset-generatorSkill
- whatdidimissSkill
- wiki-writeSkill
- writing-plansSkill
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 5 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 6 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 31
Read it when you are asked to read the scratchpad
- Distinctive: line 32
Use for critical session facts: "Project uses bun", "On branch feature/xyz", "Don't touch the legacy monolith"
- Distinctive: line 33
Keep SHORT — this eats into your context budget
- Distinctive: line 78
Read, write, and prune the scratchpad file when asked
- Distinctive: line 79
When a Working note should be kept, write it into the Manual section when asked
- Very specific: line 80
When a session ends, stale Working entries can be pruned with /scratchpad --prune
“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Scratchpad — Compaction-Resilient Session Notes
Save important context to .scratchpad.md in the project root, a file that survives conversation compaction. Add .scratchpad.md to your .gitignore if you don't want it committed.
Why This Exists
During long sessions, context compaction drops earlier messages. Critical working notes — debugging breadcrumbs, temporary findings, "tried X because Y" — vanish. This gives you a persistent notepad with three priority tiers.
Different from memory: Memory is cross-session knowledge about the user/project. Scratchpad is within-session working state that might become memory later.
Commands
| Command | Action |
/scratchpad <content> | Add to Working Memory with timestamp |
/scratchpad --pin <content> | Add to Pinned Context (always loaded, 500 char limit) |
/scratchpad --save <content> | Add to Manual section (never pruned) |
/scratchpad --show | Display current scratchpad contents |
/scratchpad --prune | Remove Working entries older than 7 days |
/scratchpad --clear | Clear Working Memory (keep Pinned + Manual) |
Sections
Pinned Context (500 char limit)
- Read it when you are asked to read the scratchpad
- Use for critical session facts: "Project uses bun", "On branch feature/xyz", "Don't touch the legacy monolith"
- Keep SHORT — this eats into your context budget
- Overwrite semantics: new pin with same topic replaces old
Working Memory
- Timestamped session notes
- Prune these entries when asked
- Good for: debugging breadcrumbs, temporary findings, "tried X, didn't work because Y"
- Newest entries at top
Manual
- Never auto-pruned
- User-controlled permanent notes
- Good for: team contacts, deployment commands, recurring gotchas
File Format
# Scratchpad
## Pinned
Project uses bun. On branch claude/explore-feature-xyz. Legacy module is 9K lines — restyle only, don't refactor.
## Working
- [2026-04-01 20:30] Found auth bug in UserContext — missing useEffect dependency
- [2026-04-01 19:15] date-fns installed, date-range-picker.tsx created
- [2026-04-01 18:00] 4-team audit complete, ASCII atlas at docs/ASCII-SCREEN-ATLAS.md
## Manual
- Project dev server: bun dev (port 3000)
- Team contact: team@example.com
- DB studio: bun db:studioBehavior
- Creates
.scratchpad.mdin the project root if it doesn't exist - Parses argument to determine section (--pin, --save, or default Working)
- Appends with timestamp for Working entries
- Warns if Pinned exceeds 500 chars
- Confirms what was saved
Integration
- Read, write, and prune the scratchpad file when asked
- When a Working note should be kept, write it into the Manual section when asked
- When a session ends, stale Working entries can be pruned with
/scratchpad --prune
Examples
/scratchpad The sidebar width transition bug is in client-pdf.ts:800-809, re-join step
/scratchpad --pin On branch feature/date-range-picker. Don't push to main.
/scratchpad --save Project uses 5-tier PDF fallback: Typst → Cloud → Puppeteer → HTML → JSON
/scratchpad --show
/scratchpad --pruneDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

