CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

triage

Opt-in workflow for triaging one GitHub issue without fixing it. Invoked only via `/triage <github-issue-url>` (`$triage` in Codex). Establishes live state, reproduces with our own fixtures, probes real Next.js for parity, classifies the issue, and drafts the issue reply and next action. Hands valid bugs off to the fix step.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Triage GitHub Issue

Issue: $ARGUMENTS

Establish the issue's live state below, then follow references/rules.md for everything else: safety, the parity check, reproducing, the verdict and the reply. Its "Automated Runs" section doesn't apply here. In those rules, "the fix step" means the fix skill (/fix <github-issue-url>, $fix in Codex).

Do not open a PR, post a comment, change labels or close the issue without confirmation.

Input

Require one GitHub issue URL, passed as the /triage argument. If it is missing, ask for it. If it names a repository other than the current checkout, find an existing checkout of that repository before reading code.

Hard Rules

  • Triage against current main. Run git fetch origin main and compare it with the checkout's HEAD. A stale checkout produces "already fixed" mistakes.
  • Protect the GitHub API budget. Every session and automation on the account shares the quota. Read one issue with plain gh issue view --comments. Before any multi-issue sweep, run gh api rate_limit, estimate the cost, keep first: small, prefer REST or gh search, and stop when fewer than ~1,500 calls remain.
  • No PR comments on PRs with an in-flight Bonk run. Any issue comment cancels it.

1. Establish Live State

  1. Parse the URL into owner, repository and issue number.
  2. Read the issue, every comment, linked PRs and cross-references with gh.
  3. Look for an existing branch, open PR or merged fix (gh pr list --search "<number>", git log origin/main --grep). If a PR exists, check its state with gh pr view <n> --json state before suggesting any follow-up on it.
  4. Look for duplicates and earlier decisions: search open and closed issues and PRs for the same symptom, including ones where maintainers already made a parity or decline call.

Then work through references/rules.md.

2. Report and Confirm

Report to the user:

  • the verdict, with its evidence (file:line, probe output, docs, earlier decision);
  • the main SHA you triaged against;
  • the reproduction status;
  • for valid bugs: the root-cause hypothesis, the minimal change set, the suggested fixture and test, and the hand-off to the fix step;
  • the draft reply, and the proposed labels or state change.

Post the comment, change labels or close the issue only after the user confirms.

Repository

cloudflare/vinext

Path

.agents/skills/triage/SKILL.md

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.