Agent skill

Notepad System

by vibeeval in vibeeval/vibecosystem

A skill your agent uses when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks.

MITAuto-check passedAI & LLM Engineering

Install Notepad System

skills CLI
$ npx skills add vibeeval/vibecosystem --skill notepad-system -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vibeeval/vibecosystem notepad-system --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vibeeval/vibecosystem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/notepad-system .claude/skills/notepad-system && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
notepad-system
GitHub stars
531
Token cost
~1.7k tokens
SKILL.md length
541 words
Files
1
Skills in repo
144
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks.

  • Context compression is imminent
  • SKILL.md covers The Problem, Note Types, Storage Location and Pre-Compact Protocol, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Resuming a session

What it does

Notepad System is an agent skill from vibeeval/vibecosystem. Use this skill when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks. Provides a durable notepad that survives compaction and lets any agent pick up exactly where the previous context left off.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering LLM cost and token optimization. The repository describes itself as: AI software team for Claude Code - 138 agents, 295 skills, 73 hooks. Self-learning, multi-agent swarm, autonomous skill evolution. The licence is MIT.

When your agent uses it

  • Context compression is imminent
  • Resuming a session
  • Preserving critical decisions across long tasks

Example prompts

  • “/notepad-system”

What it can do on your machine

Read from SKILL.md and the folder at commit 3b763b1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notepad System loads about 1.7k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vibeeval/vibecosystem at commit 3b763b1, republished under its MIT licence (© vibeeval). 541 words, ~1,742 tokens.

Download SKILL.mdSave it as .claude/skills/notepad-system/SKILL.md (or your agent's skills folder).
name
notepad-system
description
Use this skill when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks. Provides a durable notepad that survives compaction and lets any agent pick up exactly where the previous context left off.

Notepad System — Compaction-Resistant State Preservation

Structured storage for decisions, task state, and critical context that must survive context window compression. Extends pre-compact-state.md from manual discipline to a concrete file-based protocol.

The Problem

When context compresses, the following is lost:

  • Why a specific approach was chosen over alternatives
  • Which files were edited and what changed
  • Where in a multi-step task execution was paused
  • Constraints and requirements the user stated earlier in the session

Without this, the recovered context either restarts from scratch or makes assumptions that contradict earlier decisions.


Note Types

TypePersistenceWhen to Use
PriorityPermanent until explicitly deletedArchitectural decisions, user confirmed preferences, hard constraints
WorkingSession-scoped, cleared at session endCurrent task state, WIP progress, in-flight findings
ScratchCleared after use (one-time calc)Quick calculations, temp values used once

Storage Location

~/.claude/projects/<project-hash>/notepad.md

The project hash is derived from the working directory path. If the directory does not exist, create it before writing.

File Format
markdown
# Notepad

## Priority Notes

### [2026-03-29 14:22] Decision: Auth approach
JWT with refresh tokens. User confirmed.
Reason: Stateless, scalable, mobile-friendly.
Rejected: Session-based (server state, scaling issues).

### [2026-03-29 15:10] Constraint: Node version
Must stay on Node 18. Server has LTS pinned, no upgrade path in scope.

## Working Notes

### [2026-03-29 14:45] Task: API refactor — Phase 2
Completed: /users, /products, /categories endpoints
Remaining: /orders, /payments endpoints
Blocked on: Stripe webhook secret (user to provide)
Next action: Start /orders, skip payment until secret arrives

## Scratch

### [2026-03-29 15:30] Token estimate
Average response: 256 tokens. 4x safety margin = ~1024 tokens per request budget.
USED — safe to delete.

Pre-Compact Protocol

When context compression is imminent (context window at ~80% or system warning appears):

Step 1 — Dump active task state to Working Notes

What task is in progress?
What has been completed so far?
What remains?
Are there any blockers?
What is the immediate next action when context resumes?

Step 2 — Promote any pending decisions to Priority Notes

Any architectural choice made this session → Priority Note
Any user-confirmed preference → Priority Note
Any external constraint discovered → Priority Note

Step 3 — Record modified files

List every file touched this session.
Note what changed in each (one line per file is enough).
Note whether changes are committed or uncommitted.

Step 4 — Save pending decisions with their options

If a decision was not yet made, record the question and the options.
This prevents re-deriving the same options after compression.

Do this BEFORE continuing work. State preservation takes priority.


Post-Compact Recovery

When a new or compressed context begins:

Step 1 — Read notepad.md

Path: ~/.claude/projects/<project-hash>/notepad.md

Step 2 — Inject Priority Notes into active context These are always relevant. Treat them as if the user stated them at session start.

Step 3 — Summarize Working Notes for the user

"Resuming: API refactor, Phase 2.
Completed: /users, /products, /categories.
Remaining: /orders, /payments.
Blocked: Stripe webhook secret needed.
Next: starting /orders."

Step 4 — Clear Scratch notes They were single-use. Remove them now.

Step 5 — Resume from last known state Do not ask the user to re-explain context that is in Working Notes.


Note Writing Rules

  • Priority notes require explicit deletion: notepad delete priority <title>
  • Working notes are cleared at the end of each session (or when the task completes)
  • Never store code in notes — reference file.ts:line instead
  • Keep each note to 3 lines maximum (reference files for detail)
  • Always include a timestamp in the note header
  • Never duplicate information already in CLAUDE.md or memory — cross-reference instead

Show full SKILL.md (191 more words)Show less

CLI Operations (manual use)

Read the notepad:

bash
cat ~/.claude/projects/<hash>/notepad.md

Clear working notes (session end):

bash
# Remove the Working Notes section content, keep the headers

Clear scratch notes (after use):

bash
# Remove individual scratch entries after they have been applied

Integration

pre-compact-state.md — This skill is the concrete implementation of that rule. The rule defines what to save; this skill defines where, how, and in what format.

compass agent — The compass agent performs context recovery. It should read notepad.md as its first action and use the contents to construct the "Nerede kalmistik?" summary.

Any agent — Any agent starting work on a project should check notepad.md for Priority Notes that constrain their approach. An architect should not propose a solution that contradicts a Priority Note.


Example Scenarios

Scenario 1: Mid-refactor compression

Working on a large refactor across 12 files. Context at 80%.

Pre-compact dump:

markdown
### [2026-03-29 16:00] Task: Auth system refactor — 7/12 files done
Completed: user.service.ts, auth.controller.ts, token.service.ts,
  session.middleware.ts, logout.handler.ts, login.handler.ts, refresh.handler.ts
Remaining: password.service.ts, oauth.handler.ts, 2fa.handler.ts,
  admin.auth.ts, tests/auth.test.ts
Next: start password.service.ts — method signature unchanged, internals only

After compression, any agent reads this and knows exactly which 5 files remain.

Scenario 2: Decision under uncertainty

User asked about caching strategy but has not confirmed yet.

Scratch note:

markdown
### [2026-03-29 16:15] Pending: Caching strategy
Options: (a) Redis — fast, requires infra; (b) in-memory — simple, no persistence
Awaiting user confirmation on whether Redis is available in prod.

This prevents re-deriving the same question after compression.

Scenario 3: Hard constraint from early conversation

User mentioned early in a long session that they cannot use PostgreSQL — MySQL only.

Priority note created immediately:

markdown
### [2026-03-29 10:05] Constraint: Database — MySQL only
No PostgreSQL. Server is MySQL 8.0. All queries and schema must be MySQL-compatible.
Reason: Hosting provider limitation.

Every subsequent agent reads this and never proposes PostgreSQL.

© vibeeval, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/notepad-system of vibeeval/vibecosystem.

Open the folder on GitHubat commit 3b763b1

Compare with similar skills

Notepad System next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notepad System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notepad System this skillvibeeval/vibecosystem531—~1.7kAutomated safety check: PassMIT
Context Compressionguanyang/open-agent-hub9732 repos~4.6kAutomated safety check: PassMIT
Bounty Hunter1sadjlk/bounty-hunter-skill2821 repos~761Automated safety check: PassMIT
Skill Shortenerluongnv89/asm953—~3.8kAutomated safety check: NotesMIT
Fleet Auditoralexgreensh/token-optimizer2.5k—~1.7kAutomated safety check: PassCustom licence
Context Auditundefined-ui/second-brain-os999—~810Automated safety check: PassMIT

Similar skills

  • Context Compression

    guanyang/open-agent-hub

    This skill should be used when long-running agent sessions need context compression, structured summarization, compaction, token-per-task optimization, or durable handoff summaries that preserve…

    973 GitHub starsUsed in 2 repos~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Bounty Hunter

    1sadjlk/bounty-hunter-skill

    A professional AI bounty hunter persona named Atlas. An agent skill from 1sadjlk/bounty-hunter-skill.

    282 GitHub starsUsed in 1 repo~761 tokens
    AI & LLM EngineeringAuto-check passed
  • Skill Shortener

    luongnv89/asm

    Refactor a too-long SKILL.md by progressive disclosure: measure token cost, classify every section KEEP/CUT/MOVE, shorten the body into references/ and scripts/, verify nothing was lost.

    953 GitHub stars~3.8k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes
  • Fleet Auditor

    alexgreensh/token-optimizer

    Cross-system agent token/cost audit (Claude Code, Codex, OpenClaw, Hermes, OpenCode): idle burns, model misrouting, config bloat, with dollar savings.

    2.5k GitHub stars~1.7k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Context Audit

    undefined-ui/second-brain-os

    Audit an agent's context layout against the four places: system prompt, tools, history, tail.

    999 GitHub stars~810 tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed
  • Headroom

    momori777/Artemis

    SmartCrusher + CCR context compression — crunch large JSON arrays, tool outputs, and search results to save tokens.

    377 GitHub stars~562 tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed

More from vibeeval/vibecosystem

All 144 skills in this repo
  • Agent Benchmark

    vibeeval/vibecosystem

    Framework for measuring and tracking agent response quality over time.

    531 GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Differential Review

    vibeeval/vibecosystem

    Security-focused differential code review with blast radius analysis, risk-adaptive depth (DEEP/FOCUSED/SURGICAL), git history correlation, and structured finding format.

    531 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Factcheck Guard

    vibeeval/vibecosystem

    A skill your agent uses when making any factual claim about the codebase — existence, absence, or behavior.

    531 GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Fp Check

    vibeeval/vibecosystem

    Systematic false positive verification for security findings.

    531 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • N8n Workflows

    vibeeval/vibecosystem

    n8n otomasyon workflow'lari. An agent skill from vibeeval/vibecosystem.

    531 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Property Based Testing

    vibeeval/vibecosystem

    Property-based testing (PBT) patterns with fast-check (JS/TS), Hypothesis (Python), and gopter (Go).

    531 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Notepad System

What does Notepad System do?

A skill your agent uses when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks. Notepad System is an agent skill from vibeeval/vibecosystem. Use this skill when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks.

When should I use Notepad System?

Notepad System fits situations like: context compression is imminent; resuming a session; preserving critical decisions across long tasks.

How do I install Notepad System in Claude Code?

Run `npx skills add vibeeval/vibecosystem --skill notepad-system -a claude-code`. Or copy the skill folder (skills/notepad-system in vibeeval/vibecosystem) into .claude/skills/notepad-system in your project. Claude Code loads it when a task matches its description.

How do I install Notepad System in Codex?

Run `npx skills add vibeeval/vibecosystem --skill notepad-system -a codex`. Or copy the skill folder (skills/notepad-system in vibeeval/vibecosystem) into .agents/skills/notepad-system in your project. Codex loads it when a task matches its description.

Can I use Notepad System in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vibeeval/vibecosystem --skill notepad-system -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notepad-system, .gemini/skills/notepad-system, .github/skills/notepad-system and .opencode/skills/notepad-system in your project.

What does Notepad System need to run?

SKILL.md names no scripts, command-line tools or credentials: Notepad System is instructions for the agent only.

Does Notepad System access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Notepad System safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notepad System use?

Notepad System is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notepad System use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Notepad System?

Skills that share tags, products or a category with Notepad System: Context Compression (guanyang/open-agent-hub, 973 stars), Bounty Hunter (1sadjlk/bounty-hunter-skill, 282 stars), Skill Shortener (luongnv89/asm, 953 stars) and Fleet Auditor (alexgreensh/token-optimizer, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notepad System?

vibeeval (a GitHub user) maintains it in vibeeval/vibecosystem, which has 531 GitHub stars. The repository holds 144 skills in this directory. The repository was last updated on August 8, 2026.

Source: vibeeval/vibecosystem on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.