napkin

Log mistakes, corrections, and patterns to .scratch/napkin.md.

4|1|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/sandover/codex-skills --skill napkin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: napkin
Source: https://github.com/sandover/codex-skills/tree/main/skills/napkin
Command: npx skills add https://github.com/sandover/codex-skills --skill napkin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintain a per-repo napkin file that tracks mistakes, corrections, and what works. This living document activates every session, unconditionally. Read the napkin before doing anything, and write to it continuously as you work — not just at session boundaries. Log your own mistakes, not just user corrections. The napkin lives in the repo at .scratch/napkin.md.

Core Features & Use Cases

  • Always-on memory: napkin is read at session start and updated continuously as you work.
  • Structured sections: Corrections, User Preferences, Patterns That Work, Patterns That Don't Work, and Domain Notes help you organize lessons and decisions.
  • Local provenance: the napkin lives in your repository for versioning and collaboration.
  • Adaptable to any project: redesign sections to fit the repo's domain and workflow.

Quick Start

Create or open the file .scratch/napkin.md in your repository at the start of each session and begin logging notes continuously.

Frequently Asked Questions about napkin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track mistakes and corrections within a code repository?

A living document tracks mistakes and corrections by logging them continuously into a structured in-repo file at .scratch/napkin.md, preserving context across sessions for continuous improvement.

What is the best way to maintain continuous improvement notes in a repo?

The best way to maintain continuous improvement notes is using a living document activated at session start that organizes insights into structured sections for Corrections, User Preferences, and Patterns within the repository.

How do I log session insights for continuous improvement during development?

Log session insights by opening a running notes file at session start and updating it continuously during work, recording mistakes, corrections, and patterns in structured markdown sections for ongoing reference.

Can I customize the documentation sections for my specific project workflow?

Yes, you can customize the documentation sections. The structured sections for Corrections, User Preferences, and Patterns can be redesigned to fit your specific repository domain and workflow requirements.

Does the napkin approach require any external dependencies to store notes?

No, the napkin approach requires zero external dependencies. Notes are stored locally as a markdown file within your repository, leveraging standard version control for tracking and collaboration.

When should I not use a living document for learning in my repo?

Avoid using a living document for learning if your workflow cannot accommodate continuous updates during sessions. The system relies on unconditionally reading the file at start and writing to it continuously during work.