document-gotchas

Community

Consolidate and manage development gotchas.

AuthorGDSDN
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill automates the extraction, deduplication, categorization, and consolidation of development "gotchas" (common mistakes, anti-patterns, or tricky issues) from session insights into a searchable knowledge base.

Core Features & Use Cases

  • Automated Extraction: Pulls gotchas from various insight fields (gotchasFound, discoveries, patternsLearned).
  • Deduplication & Categorization: Ensures a clean, organized knowledge base by removing duplicates and assigning categories.
  • Knowledge Base Generation: Creates human-readable (gotchas.md) and machine-readable (gotchas.json) outputs.
  • Use Case: After a development session where an agent encountered several tricky TypeScript inference issues, this skill automatically adds them to a central gotchas.md file, making it easy for the team to learn from past mistakes.

Quick Start

Update the gotchas knowledge base by running the document-gotchas update command.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: document-gotchas
Download link: https://github.com/GDSDN/kord-aios/archive/main.zip#document-gotchas

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.