pitfall

What problem does it solve?

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).

Core Features & Use Cases

• 5-Element Pitfall Capture: Extracts and stores Tried, Failed, Cause, Fix, and Trigger as a single, consistent record.
• Intelligent Medium Routing: Automatically decides whether the pitfall belongs in memory, documentation, or both based on whether it’s generally applicable or project-specific.
• Duplicate Prevention (Idempotent SKIP): Runs a Grep check against likely sink locations and skips saving if the same trigger is already recorded.
• Guardrails for Incomplete Data: If any of the five elements are missing, it pauses to ask the user for the missing parts and avoids saving incomplete entries.

Quick Start

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".