pitfall-record

pitfall-record is a skill for Claude Code from Stanshy/AgentHub. It costs 17 tokens per session (324 once invoked), scanned A, original, MIT.

A postmortem log entry workflow for documenting a problem, its cause, solution, and prevention.

In plain words
What is it for?
It is for recording build, runtime, deployment, test, or process pitfalls with an expiry date and a follow-up status.
Why use it?
Writing down lessons from failures helps the team remember what happened and avoid repeating it.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions CLAUDE.md; positional $N argument.

Good fit It is for recording build, runtime, deployment, test, or process pitfalls with an expiry date and a follow-up status.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/stanshy/agenthub/pitfall-record
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Stanshy/AgentHub --skill pitfall-record
Clone the repo
git clone --depth 1 https://github.com/Stanshy/AgentHub

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pitfall-record

README.md
[![agentmods](https://agentmods.dev/badge/skills/stanshy/agenthub/pitfall-record/github.svg)](https://agentmods.dev/skills/stanshy/agenthub/pitfall-record)
Your own site
<a href="https://agentmods.dev/skills/stanshy/agenthub/pitfall-record"><img src="https://agentmods.dev/badge/skills/stanshy/agenthub/pitfall-record/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pitfall-record

Your own site · 80×15
<a href="https://agentmods.dev/skills/stanshy/agenthub/pitfall-record"><img src="https://agentmods.dev/badge/skills/stanshy/agenthub/pitfall-record.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 17 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 324 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00017 $0.00324
Opus 5.5 $0.00007 $0.00130
Sonnet 5.5 $0.00003 $0.00065
Haiku 4.5 $0.00002 $0.00032

Measured 1mo ago against content hash 49607ba9865b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

pitfall-record scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.knowledge/company/skill-templates/pitfall-record/SKILL.md · 45 lines

What it actually says

踩坑紀錄

將踩坑經驗記錄到 postmortem log。

使用方式

/pitfall-record <category> <title>

參數

  • $0: 分類(build / runtime / deploy / test / process)
  • $1: 標題
  • $ARGUMENTS: 完整描述

執行步驟

  1. 讀取現有 postmortem log: !cat .knowledge/postmortem-log.md 2>/dev/null | tail -20 || echo "尚無踩坑紀錄"

  2. 計算到期日:紀錄日期 + 14 天,格式為 YYYY-MM-DD。

  3. 在 .knowledge/postmortem-log.md 末尾 append:

### {日期} — $1

| 項目 | 內容 |
|------|------|
| 分類 | $0 |
| 問題 | {問題描述} |
| 原因 | {根本原因} |
| 解法 | {解決方式} |
| 預防 | {未來如何避免} |
| 狀態 | open |
| 到期日 | {日期+14天, YYYY-MM-DD 格式} |
  1. 如果涉及通用規則,建議是否需更新 CLAUDE.md 或公司規範。
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 45 lines · 17 tokens per session scan A 49607ba9865b

Subscribe to this mod's changes

pitfall-record is a skill published in the GitHub repository Stanshy/AgentHub (204 stars, last pushed 6mo ago), licensed MIT. It adds 17 tokens to every session and 324 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

troubleshoot

Investigate unexpected chat agent behavior by analyzing direct debug logs in JSONL files. Use when users ask why something happened, why a request was slow, why tools or subagents were used or skipped, or why instructions/skills/agents did not load.

microsoft/vscode · 55 tokens

md-audit

Read-only code quality audit — scan the current working directory for common issues (bugs, dead code, security hotspots, missing error handling) and return a prioritised findings report. No files are edited. Use when asked to "audit the code", "quick audit", "find issues", "code scan", or "what's wrong with this…

chaitanyagiri/munder-difflin · 85 tokens

G2 Legend Expert

Expert skill for G2 legend development - provides comprehensive knowledge about legend rendering implementation, component architecture, layout algorithms, and interaction handling. Use when implementing, customizing, or debugging legend functionality in G2 visualizations.

foryourhealth111-pixel/Vibe-Skills · 47 tokens

comet-hotfix

Comet preset path: Bug fix / hotfix. Skip brainstorming, directly open → build → verify → archive. Applicable for behavior fixes, scenarios not involving new capability design.

rpamis/comet · 40 tokens

node-zombie-guardian

Use when diagnosing stale or orphaned Node.js processes launched by VCO, auditing ownership/liveness, or safely simulating cleanup without touching external Node workloads.

foryourhealth111-pixel/Vibe-Skills · 37 tokens

winapp-sandbox

Run, debug, and UI-automate a Windows app in a persistent Windows Sandbox rather than the user's desktop. Use for disposable app testing, guest diagnostics, file transfer, and app or whole-desktop evidence. Builds remain on the host; connection and reconnect can briefly take focus.

microsoft/winappCli · 62 tokens