Name: debug-code
Author: definableai

About

Imported from definableai/definable.ai (definable/definable/skill/library/debug-code/SKILL.md). Install upstream with npx skills add definableai/definable.ai --skill debug-code. Copyright stays with the author.

When to Use

Use this skill when diagnosing bugs, errors, unexpected behavior, or performance issues in code. Applies to runtime errors, logic bugs, test failures, and configuration problems.

Steps

Reproduce: Confirm the exact error message, stack trace, or unexpected behavior. Identify the minimal reproduction steps.
Locate: Trace the error to its origin. Follow the stack trace, identify the failing function, and note the input that triggers the bug.
Hypothesize: Form 2-3 candidate explanations for the failure. Consider: wrong input, incorrect logic, missing initialization, race condition, dependency issue.
Test hypotheses: For each hypothesis, identify what evidence would confirm or refute it. Check variable values, execution paths, and preconditions.
Root cause: Identify the actual root cause (not just the symptom). Ask "why?" until you reach the fundamental issue.
Fix: Propose a minimal, targeted fix. Explain why it addresses the root cause without introducing side effects.
Verify: Describe how to verify the fix works and doesn't break other functionality.

Rules

Never guess — trace the actual execution path with evidence.
Distinguish between symptoms and root causes. A crash is a symptom; the unvalidated input that caused it is the root cause.
Consider recent changes as the most likely source of new bugs.
Check the simplest explanations first (typos, wrong variable, missing import) before complex ones.
If the bug is in a dependency or library, say so rather than working around it blindly.

Output Format

Error: The exact error or unexpected behavior.
Root Cause: What is actually going wrong and why.
Fix: The specific code change needed.
Verification: How to confirm the fix works.
Prevention: How to prevent similar bugs in the future (tests, types, assertions).

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/definableai-definable-ai-debug-code/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

definableai-definable-ai-debug-code.ocm.jsonjson

{
  "ocm": "1",
  "id": "definableai-definable-ai-debug-code",
  "kind": "skill",
  "name": "debug-code",
  "description": "Systematic debugging methodology",
  "publisher": "definableai",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "debug",
      "troubleshoot",
      "errors",
      "bugs",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Systematic debugging methodology"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/definableai/definable.ai",
      "path": "definable/definable/skill/library/debug-code/SKILL.md",
      "ref": "3dce5b64694d345acd933cc1e5608156e52d4fd8",
      "url": "https://github.com/definableai/definable.ai/blob/3dce5b64694d345acd933cc1e5608156e52d4fd8/definable/definable/skill/library/debug-code/SKILL.md",
      "key": "definableai/definable.ai/definable/definable/skill/library/debug-code/SKILL.md"
    }
  },
  "instructions": "## When to Use\n\nUse this skill when diagnosing bugs, errors, unexpected behavior, or performance issues in code. Applies to runtime errors, logic bugs, test failures, and configuration problems.\n\n## Steps\n\n1. **Reproduce**: Confirm the exact error message, stack trace, or unexpected behavior. Identify the minimal reproduction steps.\n2. **Locate**: Trace the error to its origin. Follow the stack trace, identify the failing function, and note the input that triggers the bug.\n3. **Hypothesize**: Form 2-3 candidate explanations for the failure. Consider: wrong input, incorrect logic, missing initi",
  "cost": {
    "context_tokens": 476
  }
}

Fetch it by URL: GET /api/v1/registry/definableai-definable-ai-debug-code/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.