gotchas

Manage and retrieve project issues with categories, severities, and workarounds.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps manage and retrieve known issues, workarounds, and their associated details within a project, ensuring developers are aware of and can quickly address common problems.

Core Features & Use Cases

  • List Gotchas: Display all known gotchas with filtering by category, severity, or unresolved status.
  • Search Gotchas: Find specific gotchas using keywords.
  • View Statistics: Get an overview of gotcha distribution by category, severity, and source.
  • Use Case: A developer encounters a recurring error. They can use gotchas search {error_message} to see if it's a known issue with a documented workaround, saving debugging time.

Quick Start

List all unresolved critical gotchas in the project.

Frequently Asked Questions about gotchas

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

FAQPage Schema
How do I document and retrieve known project issues and workarounds?

Document and retrieve known project issues by storing them as gotchas in a persistent JSON file. Each entry includes descriptions, categories, severities, and workarounds, enabling developers to quickly access and address documented problems.

How do I filter known issues by severity and resolution status?

Filter known project gotchas by category, severity, or unresolved status to quickly surface relevant issues. You can also use keyword search to find specific gotchas matching error messages or terms.

Can I search for a specific error message to check if it is a known gotcha?

Yes, you can search gotchas using keywords to find if a specific error message is a known issue. This retrieves documented descriptions and workarounds from the persistent JSON memory, saving debugging time.

How do I get an overview of project issue distribution by category and severity?

Generate statistical summaries of gotchas to get an overview of their distribution by category, severity, and source. This provides a clear picture of where project issues cluster and their overall impact.

What is the best way to manage recurring errors and their workarounds during development?

Manage recurring errors by logging them as gotchas with their workarounds in a persistent JSON memory. Developers can then retrieve these documented solutions, ensuring quick resolution of common problems.

Do I need any external dependencies to manage gotchas and workarounds?

No external dependencies are required to use the gotchas management Skill. It operates using internal scripts and references, storing issue data directly in a persistent JSON file for retrieval.