add-pitfall

What problem does it solve?

It removes the manual effort and mistakes involved in updating the CLAUDE.md “Common Pitfalls” table by auto-determining the next pitfall number and inserting a correctly formatted row.

Core Features & Use Cases

• Auto-numbered insertion: Detects the highest existing | NNN | entry and assigns highest + 1 for the new row.
• Table-structure safe formatting: Generates a single row with exactly four pipe-separated columns that matches the existing markdown style.
• Targeted edit only: Inserts the new row at the end of the numbered pitfalls table without touching the separator or the “Extended Reference” section.
• Use case: When documenting a newly discovered pitfall in an engineering area (e.g., Routing, Memory, Security), add it consistently without misnumbering or breaking the table.

Quick Start

Use the add-pitfall skill to add a new pitfall row to the Common Pitfalls table in CLAUDE.md by issuing a single command like /add-pitfall Routing "Pitfall goes here" "Correct pattern goes here".