brain-check

Cursor skills that fight cognitive debt — the knowledge gap that grows when AI writes code and you just accept it.

Two commands:

• /brain-check — Quick quiz (3-5 questions) after completing a task, testing your understanding of what was just built.
• /brain-refresh — Spaced repetition review of past tasks using an adaptive 1-day / 1-week / 1-month schedule.

How It Works

brain-check (end-of-task quiz)

After you finish a task, the agent offers a short multiple-choice quiz. Four question types:

Type	Tests
"What does this do?"	Can you read the code?
"Why this choice?"	Do you understand the trade-offs?
"What would break if...?"	Do you see the dependencies?
"Predict the output"	Can you reason about behavior?

Results are saved as learning cards in a memory bank for later review.

brain-refresh (spaced repetition)

Reviews past tasks on an adaptive schedule. Each card progresses through levels:

Level 0 (new)  --correct-->  Level 1  --correct-->  Level 2  --correct-->  Graduated
    ^                           |                       |
    |         incorrect         |       incorrect       |
    +---------------------------+-----------------------+

Level	Interval	Question Angle
0 → 1	1 day	Direct recall
1 → 2	1 week	Deeper understanding
2 → 3	1 month	Connections & application
3	Graduated	Never asked again

Wrong answer at any level resets the card to level 0 (review tomorrow).

On session start, if reviews are due, the agent suggests: "We haven't done our brain-refresher today — want to take it now?"

Install

git clone <repo-url> ~/code/brain-check
cd ~/code/brain-check
./install.sh

The installer:

1. Copies skills to ~/.cursor/skills/ (personal, works across all projects)
2. Initializes the memory bank if it doesn't exist
3. Optionally copies rules to your current project's .cursor/rules/

To add rules to another project later:

cp ~/code/brain-check/rules/*.mdc <project>/.cursor/rules/

Uninstall

cd ~/code/brain-check
./uninstall.sh

You'll be asked whether to keep your memory bank (review history).

Memory Bank

Your learning cards are stored in ~/.cursor/skills/brain-refresh/memory.json.

To reset all progress:

echo '{ "last_refresh_date": null, "cards": [] }' > ~/.cursor/skills/brain-refresh/memory.json

Structure

skills/
  cognitive-quiz/SKILL.md   # /brain-check logic
  brain-refresh/SKILL.md    # /brain-refresh logic
rules/
  brain-check.mdc           # Offers quiz after task completion
  brain-refresh.mdc         # Suggests review on session start

License

MIT