gotcha

Add known issues with titles, descriptions, categories, and severity to project memory.

3|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/GDSDN/kord-aios --skill gotcha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gotcha
Source: https://github.com/GDSDN/kord-aios/tree/main/src/features/builtin-skills/kord-aios/documentation/gotcha
Command: npx skills add https://github.com/GDSDN/kord-aios --skill gotcha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers and teams document and manage known issues, workarounds, and potential pitfalls within a project, preventing recurring mistakes and improving knowledge sharing.

Core Features & Use Cases

  • Add Gotchas: Manually record new issues with titles, descriptions, categories, and severity levels.
  • Automated Categorization: Intelligently suggests categories (build, test, lint, runtime, etc.) based on the gotcha's title and description.
  • Use Case: A developer encounters a tricky build configuration issue. They use the gotcha skill to record the problem, the workaround, and mark it as a 'build' category 'critical' severity, ensuring future team members can quickly find and apply the solution.

Quick Start

Add a new gotcha to the project's memory by providing its title and an optional description.

Frequently Asked Questions about gotcha

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

FAQPage Schema
How do I document known issues and workarounds for a software project?

You can document known issues by manually adding a gotcha to the project's memory, storing the title, description, category, and severity to prevent recurring mistakes. This approach ensures team members can quickly find and apply the correct workaround.

How does automated categorization work for project gotchas?

Automated categorization for project gotchas works by intelligently suggesting categories like build, test, lint, or runtime based on keywords found in the gotcha's title and description. This allows for quick classification without manual sorting.

What is the best way to track build configuration issues and their workarounds?

The best way to track build configuration issues is to record the problem and workaround as a gotcha, marking it with a 'build' category and 'critical' severity. This ensures future team members can quickly find and apply the solution.

Can I manually override the severity and related files for a known issue?

Yes, you can manually override the severity and related files for a known issue. While the system supports automated category detection based on keywords, it allows manual overrides to ensure accurate tracking of specific project pitfalls.

How are documented project gotchas stored for persistent retrieval?

Documented project gotchas are stored for persistent retrieval by integrating with GotchasMemory. This integration ensures that recorded issues, workarounds, and potential pitfalls remain accessible for future reference across the project lifecycle.

When should I document a workaround instead of fixing the underlying code?

You should document a workaround as a gotcha when you need to record known issues, build configurations, or potential pitfalls that cannot be immediately resolved. This prevents recurring mistakes by ensuring the team has immediate access to the temporary solution.