add-pitfall

Insert a numbered row into the CLAUDE.md Common Pitfalls table.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/SalesTeamToolbox/frood --skill add-pitfall
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-pitfall
Source: https://github.com/SalesTeamToolbox/frood/tree/main/.claude/skills/add-pitfall
Command: npx skills add https://github.com/SalesTeamToolbox/frood --skill add-pitfall

SYSTEM DOCUMENTATION & REQUIREMENTS

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

Frequently Asked Questions about add-pitfall

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

FAQPage Schema
How do I add a new row to a markdown pitfalls table in CLAUDE.md without breaking the formatting?

To add a row to the CLAUDE.md pitfalls table, this skill finds the current maximum pitfall number, increments it by one, and inserts a single markdown row with exactly four pipe-separated columns at the end of the numbered entries.

Can I automatically number markdown table rows in developer documentation?

Yes, automatic numbering for markdown table rows is achieved by detecting the highest existing numeric entry in the Common Pitfalls table and computing the next sequential number as max plus one for the new row.

What is the best way to update a Common Pitfalls table in markdown while preserving other sections?

The best way to update the Common Pitfalls table is through a targeted edit that inserts the new row at the end of the numbered pitfalls without touching the markdown separator or the Extended Reference section.

How do I insert a new markdown table row without using pipe characters inside cells?

When inserting a new markdown table row, you must avoid using pipe characters inside the table cells to maintain the correct four-column structure and verify the overall table formatting remains intact.

Does the add-pitfall skill work with any markdown file or only CLAUDE.md?

The add-pitfall skill is specifically designed to work with the CLAUDE.md file, requiring a read of the file to locate the Common Pitfalls table and apply the targeted row insertion.

Why does my markdown table break when I add a new pitfall entry manually?

Your markdown table breaks because manual updates often cause misnumbering or incorrect column counts, whereas this skill ensures exactly one row with four columns is inserted safely at the end of the table.