napkin

Solid

Maintain a per-repo napkin as a continuously curated runbook (not a session log). Activates EVERY session. Read and curate it before work, keep only recurring high-value guidance, organize by priority-sorted categories, and cap each category at top 10 items. The napkin lives at `.claude/napkin.md`.

AI & Automation 14 stars 1 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 86/100

Stars 20%
39
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Napkin You maintain a per-repo markdown runbook, not a chronological log. The napkin must be continuously curated for fast reuse in future sessions. **This skill is always active. Every session. No trigger required.** ## Session Start: Read And Curate First thing, every session — read `.claude/napkin.md` before doing anything else. Internalize what's there and apply it silently. Don't announce that you read it. Just apply what you know. Every time you read it, curate it immediately: - Re-prioritize items by importance (highest first). - Merge duplicates and remove stale/low-signal notes. - Keep only recurring, high-frequency guidance. - Ensure each item contains an explicit "Do instead" action. - Enforce category caps (top 10 per category). If no napkin exists yet, create one at `.claude/napkin.md`: ```markdown # Napkin Runbook ## Curation Rules - Re-prioritize on every read. - Keep recurring, high-value notes only. - Max 10 items per category. - Each item includes date + "Do instead". ## Execution & Validation (Highest Priority) 1. **[YYYY-MM-DD] Short rule** Do instead: concrete repeatable action. ## Shell & Command Reliability 1. **[YYYY-MM-DD] Short rule** Do instead: concrete repeatable action. ## Domain Behavior Guardrails 1. **[YYYY-MM-DD] Short rule** Do instead: concrete repeatable action. ## User Directives 1. **[YYYY-MM-DD] Directive** Do instead: exactly follow this preference. ``` Adapt categories to the repo, but keep category structu...

Details

Author
SZoloth
Repository
SZoloth/skill-pack
Created
6 months ago
Last Updated
yesterday
Language
HTML
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

napkin

The back-of-napkin senior. Turn any messy plan, strategy, roadmap, or system description into four boxes and three arrows — discrete phases, the gate that unlocks each one, and the flywheel that compounds. A thinking discipline, not a diagram renderer: it draws the line where the plan has no proof (so you stop building ahead of demand) and circles the loop that pays for itself. Token-frugal by design — the model emits a small spec, a script does the drawing. Use whenever the user says "napkin", "napkin this", "sketch this plan", "fit it on a napkin", "phases", "roadmap", "flywheel", "gate this plan", "distill this strategy", "phase-gate", "how does this compound", or pastes a sprawling plan and wants the shape of it.

0 Updated 6 days ago
theYahia
AI & Automation Listed

learn

Run a session retrospective — extract lessons from what happened and persist them where they'll be found next time (CLAUDE.md, MEMORY.md, handoff.xml, skills). Invoke proactively after painful debug sessions, unexpected breakthroughs, end of significant work, or when a pattern recurs across sessions. Apply Kaizen — small improvements, compounded.

1 Updated 1 weeks ago
TomasLicek
Code & Development Listed

ck-notes

cad-khana's delta on the shared notes machinery — which `_notes/` file plays which role in the demand-driven loop (worklist, field-notes, slice briefs, two-way handoffs, adoption inventory), the bookkeeping a session owes when a slice closes, and the traps that have actually bitten (stale commit SHAs after a history rewrite, consolidating shipped `ideas.md` rows, deleting a field-note that still backs an open row, promoting at f×1 on a rationale the policy doesn't name). Invoke before updating the worklist, triaging field-notes, closing a shipped `ideas.md` row, or writing/closing a slice brief or cross-repo handoff.

15 Updated 1 months ago
cyberchitta