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.