mcpField
T
triage

triage

github.com/withastroDevelopment63.6k379 installsUpdated 1d ago
Repository

About triage

A skill for end-to-end bug report triage, intended for development workflows that need to reproduce issues, diagnose causes, and check whether behavior is intentional. It uses findings to decide whether to attempt a fix and limits retries when infrastructure blocks progress.

Key features

  1. 01Use provided details or fetch a GitHub issue
  2. 02Reproduce issues in isolated context
  3. 03Diagnose causes and verify expected behavior
  4. 04Decide whether to attempt a fix

Use cases

  1. 01Investigate GitHub bug reports
  2. 02Check whether an issue is reproducible
  3. 03Try a fix after identifying unintended behavior

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/withastro/astro --skill triage

After installing, type/triagein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

diagnose.md
fix.md
reproduce.md
verify.md
evals/
evals.json

Details

From the project README

Triage

Triage a bug report end-to-end: reproduce the bug, diagnose the root cause, verify whether the behavior is intentional, and attempt a fix.

General Rules

Do not get stuck on infrastructure problems. If a server won't start, a port is blocked, or a tool is unavailable in the CI environment — bail out after 2 attempts and write your report with the data you already have. Looping on server restarts or missing CLI tools wastes your entire time budget. A partial report with solid findings is infinitely more valuable than no report because you ran out of time fighting a stale process.

Input

You need either:

  • issueTitle and issueBody provided in args (preferred — use these directly as the bug report), OR
  • A GitHub issue number or URL mentioned in the conversation (use gh issue view to fetch details)

If a triageDir is provided in args, use that as the working directory for the triage. Otherwise, default to triage/gh-<issue_number> (if you have an issue number) or triage/current.

Step 1: Reproduce

Read and follow reproduce.md. Use a subagent for this step to isolate context.

After completing reproduction, check the result:

  • If the issue was skipped (host-specific, unsupported version, etc.) — skip to Output.
  • If the issue was not reproducible — skip to Output.
  • If the issue was reproduced — continue to Step 2.

Step 2: Diagnose

Read and follow diagnose.md. Use a subagent for this step to isolate context.

After completing diagnosis, check your confidence:

  • If confidence is low — skip to Output.
  • If confidence is medium or high — continue to Step 3.

Step 3: Verify

Read and follow verify.md. Use a subagent for this step to isolate context.

After completing verification, check the verdict:

  • If the verdict is intended-behavior — skip to Output. The issue is not a bug; do not attempt a fix.
  • If the verdict is bug or unclear — continue to Step 4.

Step 4: Fix

Read and follow fix.md. Use a subagent for this step to isolate context.

Whether the fix succeeds or fails, continue to Output.

Output

After completing the triage (or exiting early), return your structured results so the orchestrator can post a comment and manage labels.

Comments

Markdown supported