Capture session trial-and-error mistakes as five-field pitfall records.
npx skills add https://github.com/ejoongseok/claude-settings --skill pitfall
Please help me install this Agent Skill. Skill: pitfall Source: https://github.com/ejoongseok/claude-settings/tree/main/claude-code/skills/pitfall Command: npx skills add https://github.com/ejoongseok/claude-settings --skill pitfall
This Skill helps you stop repeating the same session mistakes by capturing each “trial-and-error” as a structured 5-part record and storing it to the right place (memory or project documentation).
Use the pitfall skill to capture the latest session mistake by asking the assistant to run: pitfall --target both --note "Briefly describe what went wrong and what you changed to fix it".
High-intent search queries and answers about installing and using this skill.
To capture session mistakes, you record each trial-and-error event as a structured five-field entry—Tried, Failed, Cause, Fix, and Trigger—storing it in memory or project documentation to prevent repeat failures.
The best way to deduplicate knowledge capture records is running a Grep-based idempotency check against likely sink locations before writing, skipping the save operation if the same trigger is already recorded.
Structured pitfall routing decides where to save by evaluating whether the captured mistake is generally applicable or project-specific, directing the five-field record to memory, documentation, or both accordingly.
When saving incomplete pitfall data missing any of the five required fields, the process pauses to ask you for the missing parts and avoids writing incomplete entries until all fields are present.
Yes, you need frontmatter-defined YAML metadata to store trial-and-error mistakes, as it is required for medium routing, target overrides, and hard validation of the five fields before writing or updating records.
jaqgCapture end-of-session insights and persist them to the per-project memory store.
AribSudiaSearch project memory files for historical decisions using semantic and lexical methods.
NateBJones-ProjectsExtract reusable operational knowledge from work sessions into structured SKILL.md definitions.
wilsonfaustinoAutomate end-of-session knowledge capture with Obsidian notes and memory updates.
