napkin

Maintain a per-repo napkin log of mistakes and corrections in .agent/memory/napkin.md.

7|3|Updated Jul 28, 2025
One-click install
npx skills add https://github.com/oaknational/oak-open-curriculum-ecosystem --skill napkin-oaknational
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: napkin
Source: https://github.com/oaknational/oak-open-curriculum-ecosystem/tree/main/.cursor/skills/napkin
Command: npx skills add https://github.com/oaknational/oak-open-curriculum-ecosystem --skill napkin-oaknational

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintain a per-repo napkin file that tracks mistakes, corrections, and patterns that work or don't, ensuring continuous learning across sessions.

Core Features & Use Cases

  • Continuous session logging: read the napkin at the start of each session and update it as you work.
  • Mistake and correction tracking: capture errors, missteps, and the resulting fixes to build a knowledge base.
  • Rotation and distillation: archive older notes when the log grows to keep the workspace lean and focused.

Quick Start

Open or create .agent/memory/napkin.md and begin logging your session notes and mistakes as you work.

Frequently Asked Questions about napkin

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

FAQPage Schema
How do I track debugging mistakes and fixes across multiple sessions in a repository?

You can track debugging mistakes and fixes across sessions by maintaining a per-repo napkin log that records errors, corrections, and working patterns. This ensures continuous learning by preserving knowledge of what works and what does not across different workflows.

What is a per-repo napkin log for software engineering?

A per-repo napkin log is a running note of mistakes, corrections, and patterns kept within a repository. It captures errors and their resulting fixes during debugging to build a persistent knowledge base for continuous session logging.

How do I start logging session notes and mistakes in a repository?

To start logging session notes and mistakes, open or create the napkin.md file inside the .agent/memory/ directory. Read the file at the start of each session and update it continuously as you work through debugging and interactions.

Can I archive older session notes when the debugging log grows too large?

Yes, you can archive older session notes when the debugging log grows too large through automatic rotation. The system archives older notes by rotating them to a distilled.md file, keeping your workspace lean and focused on current patterns.

Does the per-repo session log require any external dependencies or components?

No, the per-repo session log does not require any external dependencies or components. It operates independently within your repository, storing all tracking data locally in markdown files inside the .agent/memory/ directory.