Pitfall Record

by Stanshy

Pitfall Record is a Writing skill for Claude Code, published by Stanshy in AgentHub.

201 stars23 forkson Stanshy/AgentHubAdded 2026/09/05+1% in starsRepository updated 2026/04/09

View source on GitHub Download repo ZIP

ai-agentsai-workflowclaude-codedeveloper-toolselectronharness-engineeringopen-sourceteam-managementtypescriptvue

Install in seconds

Install Pitfall Record

Copy Pitfall Record into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/Stanshy/AgentHub/tree/main/.knowledge/company/skill-templates/pitfall-record ~/.claude/skills/pitfall-record

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/Stanshy/AgentHub.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: .knowledge/company/skill-templates/pitfall-record/SKILL.md in Stanshy/AgentHub
Installs to: ~/.claude/skills/pitfall-record
Collection: One of 25 skills cataloged from this repository
Category: Writing — 1227 skills

What Pitfall Record does

Pitfall Record adds a lesson learned to the postmortem log with category, cause, fix, prevention, and a 14-day due date. Use it after incidents or troubleshooting to capture what happened and how to avoid it again.

Pitfall Record is cataloged under Writing on DirSkills. Pitfall Record comes from a repository tagged ai-agents, ai-workflow, claude-code, developer-tools and electron.

Documentation

README

From the original repository

踩坑紀錄

將踩坑經驗記錄到 postmortem log。

使用方式

/pitfall-record <category> <title>

參數

$0: 分類（build / runtime / deploy / test / process）
$1: 標題
$ARGUMENTS: 完整描述

執行步驟

讀取現有 postmortem log： !cat .knowledge/postmortem-log.md 2>/dev/null | tail -20 || echo "尚無踩坑紀錄"
計算到期日：紀錄日期 + 14 天，格式為 YYYY-MM-DD。
在 .knowledge/postmortem-log.md 末尾 append：

### {日期} — $1

| 項目 | 內容 |
|------|------|
| 分類 | $0 |
| 問題 | {問題描述} |
| 原因 | {根本原因} |
| 解法 | {解決方式} |
| 預防 | {未來如何避免} |
| 狀態 | open |
| 到期日 | {日期+14天, YYYY-MM-DD 格式} |

如果涉及通用規則，建議是否需更新 CLAUDE.md 或公司規範。

Commands Pitfall Record provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/pitfall-record

Frequently asked about Pitfall Record

What else does Stanshy publish alongside Pitfall Record?
Pitfall Record is one of 25 skills that DirSkills catalogs from Stanshy/AgentHub, the repository it ships in. Its siblings there include Development Plan Generator, Gate Record and Harness Audit. Each one is a separate skill with its own page in this directory, installs the same way Pitfall Record does, and is maintained by Stanshy in that same repository. The rest of the collection is listed on the Stanshy/AgentHub page.
How does Pitfall Record compare to other Writing skills?
Pitfall Record ranks #1029 by stars among the 1227 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Pitfall Record against them. Open each page to compare what they document and how they install.