triage-issue

triage-issue is a skill for Claude Code from softspark/ai-toolkit. It costs 47 tokens per session (1,170 once invoked), scanned A, original, Apache-2.0.

A bug-investigation workflow that traces a problem to its root cause and prepares a GitHub issue containing a test-driven fix plan. TDD, or test-driven development, means writing failing tests before implementing the fix.

In plain words
What is it for?
Use it to investigate bugs, inspect related code and tests, identify the root cause, and create a GitHub issue with RED-to-GREEN test steps.
Why use it?
It gives a bug report more than a symptom: it connects the failure to the relevant code and proposes how to verify the correction.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: agent in frontmatter.

Part of the ai-toolkit plugin — 113 skills, 44 agents, 14 hooks shipped together

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.

agentmods
npx agentmods add skills/softspark/ai-toolkit/triage-issue
Any agent
npx skills add softspark/ai-toolkit --skill triage-issue
Clone the repo
git clone --depth 1 https://github.com/softspark/ai-toolkit

Made for: Claude Code.

Or install ai-toolkit, the plugin that ships this one along with the rest of its 113 skills, 44 agents, 14 hooks.

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 triage-issue

README.md
[![agentmods](https://agentmods.dev/badge/skills/softspark/ai-toolkit/triage-issue.svg)](https://agentmods.dev/skills/softspark/ai-toolkit/triage-issue)
Your own site
<a href="https://agentmods.dev/skills/softspark/ai-toolkit/triage-issue"><img src="https://agentmods.dev/badge/skills/softspark/ai-toolkit/triage-issue.svg" alt="Measured on agentmods" height="20"></a>
Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,170 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00047 $0.01170
Opus 5 $0.00023 $0.00585
Sonnet 5 $0.00009 $0.00234
Haiku 4.5 $0.00005 $0.00117

Measured 2d ago against content hash 8e93f815933a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

triage-issue 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 2d 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.

app/skills/triage-issue/SKILL.md · 139 lines

How it starts

The opening of the file, as written. The whole thing — 139 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Triage Issue

$ARGUMENTS

Investigate a bug, find root cause, and create a GitHub issue with a TDD fix plan. Mostly hands-off.

Usage

/triage-issue [bug description or symptom]

What This Command Does

  1. Captures problem description (ONE question max)
  2. Explores codebase deeply for root cause
  3. Identifies fix approach
  4. Designs TDD fix plan (RED→GREEN cycles)
  5. Creates GitHub issue via gh issue create

Process

1. Capture the Problem

Get brief description. If not provided, ask ONE question: "What's the problem you're seeing?"

Do NOT ask follow-up questions. Start investigating immediately.

2. Explore and Diagnose

Use Agent (subagent_type=Explore) to deeply investigate:

Target What to look for
Manifestation Where the bug appears (entry points, UI, API)
Code path Trace the flow from trigger to symptom
Root cause Why it fails (not just the symptom)
Related code Similar patterns, adjacent modules, existing tests
Recent changes git log on relevant files
Working patterns Similar code elsewhere that works correctly

3. Identify Fix Approach

Determine:

  • Minimal change to fix root cause
  • Affected modules/interfaces
  • Behaviors to verify via tests
  • Classification: regression, missing feature, or design flaw

4. Design TDD Fix Plan

Ordered list of RED→GREEN cycles. Each cycle is one vertical slice:

  • RED: Specific test capturing broken/missing behavior
  • GREEN: Minimal code change to pass that test

Rules:

  • Tests verify behavior through public interfaces
  • One test at a time, vertical slices
  • Tests must survive internal refactors
  • Describe behaviors and contracts, not internal structure

5. Create GitHub Issue

Use gh issue create with template below. Share URL immediately.

Issue Template

Problem

  • What happens (actual behavior)
  • What should happen (expected behavior)
  • How to reproduce

Read the full file on GitHub · 139 lines

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. 2d ago First seen · 139 lines · 47 tokens per session scan A 8e93f815933a

Subscribe to this mod's changes

triage-issue is a skill published in the GitHub repository softspark/ai-toolkit (170 stars, last pushed yesterday), licensed Apache-2.0. It adds 47 tokens to every session and 1,170 once invoked, about $0.0002 per session on Opus 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-09-03.

Related

Other skills, from other repositories

systematic-debugging

4-phase root cause debugging: understand bugs before fixing.

NousResearch/hermes-agent · 16 tokens

tdd-workflow

Enforce practical Test-Driven Development for code changes in Go services. Use for new features, bug fixes, refactors, API changes, and new modules. Requires Red-Green-Refactor evidence, defect-hypothesis-driven tests, killer cases, and coverage gates (line + risk-path).

johnqtcg/awesome-skills · 65 tokens

refactor-ops

Safe refactoring patterns - extract, rename, restructure with test-driven methodology and dead code detection. Use for: refactor, refactoring, extract function, extract component, rename, move file, restructure, dead code, unused imports, code smell, duplicate code, long function, god object, feature envy, DRY…

0xDarkMatter/claude-mods · 95 tokens

fixing-bugs

Fix a bug using strict TDD — UNDERSTAND → REPRODUCE (RED) → VERIFY RED → FIX → VERIFY GREEN → VALIDATE → REFACTOR. Use when the user reports a bug, asks to fix something, mentions a Sentry/error/regression, or pastes a stack trace. Bugs require a failing test that proves the bug existed before any code change. For…

Cristhianzl/claude-skills-czl · 105 tokens

ultraqa

QA cycling workflow - test, verify, fix, repeat until goal met.

naimkatiman/continuous-improvement · 18 tokens

regression-test

Classify an iOS/Swift bug into its Apple-specific root-cause class (force unwrap, try!, fatalError, MainActor isolation, App Group mismatch, lifecycle) and sweep for sibling instances of that class. Complements a generic TDD/debugging skill (e.g. superpowers:test-driven-development, superpowers:systematic-debugging)…

markdavidgan/apple-dev-skills · 110 tokens