simon-instincts

Records repeated mistakes, project conventions, and tool quirks into four auto-loaded markdown memory files.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Simon-YHKim/eject-button --skill simon-instincts-simon-yhkim
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: simon-instincts
Source: https://github.com/Simon-YHKim/eject-button/tree/main/.claude/skills/simon-instincts
Command: npx skills add https://github.com/Simon-YHKim/eject-button --skill simon-instincts-simon-yhkim

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes scripts (resource) components.

What problem does it solve? AI assistants repeat the same mistakes across sessions because nothing persists between conversations. This Skill builds a cumulative learning memory: every time a user flags a repeated error, a project convention is discovered, or a CLI footgun is hit, it gets appended to a persistent markdown store that auto-loads at every session start. ## Core Features & Use Cases - Mistake Logging: Appends dated entries with symptom, root cause, prevention, and source to mistakes-learned.md the moment a user says "you did this again". - Four Categorized Memory Files: Separates learnings into mistakes-learned.md, project-patterns.md, korean-context.md (Korean API and UX quirks), and tool-quirks.md under ~/.claude/instincts/. - Auto-Load Bootstrap: Injects an Instincts block into ~/.claude/CLAUDE.md so all four files are referenced at every session start, with an idempotent install check. - Helper Script: scripts/append.sh appends templated entries interactively or via flags, auto-populating dates and enforcing all fields. - Use Case: A user says "λ„ˆ 이거 μ €λ²ˆμ—λ„ κ·Έλž¬μž–μ•„" about grep -c exiting 1 on zero matches; the Skill immediately appends a structured entry to tool-quirks.md so the mistake never recurs. ## Quick Start Tell the assistant to record this repeated mistake in your instincts memory so it never happens again.

Frequently Asked Questions about simon-instincts

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

FAQPage Schema
How do I make Claude Code remember mistakes across sessions?β–Ό

Use a persistent memory store under ~/.claude/instincts/ with markdown files referenced from CLAUDE.md. When a repeated mistake is flagged, append a dated entry with symptom, root cause, and prevention so it loads at every future session start.

How do I log a repeated mistake with this Skill?β–Ό

Run scripts/append.sh with a category like mistakes or tools, passing --title, --symptom, --cause, and --fix flags, or answer the interactive prompts. The script auto-populates the date and appends a templated entry to the correct file.

What files does the instincts memory system use?β–Ό

It uses four markdown files under ~/.claude/instincts/: mistakes-learned.md for errors, project-patterns.md for project conventions, korean-context.md for Korean API and UX quirks, and tool-quirks.md for CLI footguns.

Does the instincts block get added to CLAUDE.md automatically?β–Ό

Yes. The Skill includes an idempotent bash snippet that checks for the Instincts auto-loaded block in ~/.claude/CLAUDE.md and appends it only if missing, so repeated installs never duplicate the section.

When should a tool quirk not be recorded?β–Ό

Only record a CLI or harness quirk after hitting it at least twice, since a single occurrence may be coincidence. Also never store sensitive data like tokens, passwords, or internal URLs in the instincts files.