skillsaw Issue Triage
Triage a single open issue on the skillsaw linter. Check what kind of
issue it is, check whether its claims hold up against the actual code, fill in
the details it is missing, review the evidence, and leave one triage
comment. This skill triages issues — never fix them here (that job belongs to skillsaw-issue-solver).
Read the detailed evaluation checklist for each classification in references/,
and read only the checklist for the class the issue falls into (progressive disclosure).
Keep this file lean and pull the checklist in on demand.
Step 1 — Read the Issue
Run this for the issue number you were given:
gh issue view <number> --json number,title,body,labels,author,comments,createdAt
Read the title, body, and every comment before judging anything. Note the
skillsaw version the reporter names (or none), and check any config, command, or file content they pasted.
Step 2 — Classify
Set exactly one primary class. When an issue spans two, pick the one that determines the next action and note the secondary in the comment.
| Class |
The issue is… |
Evaluation checklist |
bug |
A claim that skillsaw behaves incorrectly — wrong violation, crash, false positive/negative, bad autofix |
references/bug-evaluation.md |
feature |
A request for new behavior — a new rule, flag, config option, output format, or tool/format support |
references/feature-evaluation.md |
documentation |
Docs are missing, wrong, or unclear (README, skillsaw.org, rule docs) — code behavior is not disputed |
references/other-evaluation.md |
question |
A usage/support question, not a defect or request |
references/other-evaluation.md |
other |
Duplicate, invalid, spam, out-of-scope, or needs-more-info |
references/other-evaluation.md |
Write the class and a one-sentence rationale.
Step 3 — Verify Accuracy
Read the checklist for the chosen class now (references/*.md) and work it.
Check whether the issue is accurate — do its claims match how skillsaw actually behaves?
- For a bug: run the repro against the current code. Trace the cited behavior
to the responsible rule or
src/ module, then verify it. A bug you cannot
reproduce, or that describes intended behavior, is not confirmed — always say so.
- For a feature: check whether it already exists, whether it fits skillsaw's
scope (core vs a rule plugin), and verify it would not break existing users.
- For documentation / question / other: verify the underlying facts before agreeing or redirecting.
Cite what you checked with file:line references and command output — never assert a conclusion you did not verify.
Step 4 — Enrich
Add the details the issue is missing so it is actionable without a round-trip:
- Reproduction: write a minimal repro (config + input file + command + observed vs expected) when the reporter left one out and you can construct one.
- Locus: include the rule ID, file, and line most relevant to the issue.
- Version / environment: include the version the behavior was verified against, and whether it still reproduces on
main.
- Related work: review duplicate or related issues and any open PR that already touches this (
gh issue list / gh pr list --search).
- Suggested labels: include labels (e.g.
bug, enhancement, documentation, question, duplicate, needs-info, good-first-issue), but never apply them unless asked.
Step 5 — Decide the Recommendation
Set exactly one recommendation — this is the headline of the triage comment:
| Recommendation |
When |
| 🛠️ FIX — REPRODUCED |
A real defect you reproduced or confirmed against the code (a genuinely wrong or missing doc counts here too). |
| ✨ IMPLEMENT — GOOD IDEA |
An in-scope feature worth building into skillsaw core. |
| 🔌 PLUGIN |
In skillsaw's domain but niche / single-vendor — belongs in a rule plugin, not core. Link skillsaw.org/plugins/. |
| ⛔ REJECT |
Out of scope, not reproduced, works-as-intended, invalid, duplicate, or answered. |
Follow the class checklist to decide: a bug that reproduces → FIX,
one that doesn't → REJECT; for a feature, follow the domain gate in
references/feature-evaluation.md (out of domain → REJECT, niche → PLUGIN,
broadly useful → IMPLEMENT).
Step 6 — Post One Triage Comment
Read references/triage-template.md, then post it as exactly ONE comment:
gh issue comment <number> --body "$(cat <<'TRIAGE'
<rendered triage>
TRIAGE
)"
This skill is advisory: keep its output a recommendation for a maintainer. Post
the triage comment on your own initiative, but never close, reassign, or label
the issue yourself — always leave that to a human. Follow one exception only: a
label action the invoking context directs — for instance, keep clearing an
automation's own trigger label once you post the comment. Always carry that out.
1---2name: skillsaw-issue-triage3description: Triage a GitHub issue filed against skillsaw — classify it (bug, feature, docs, question, other), verify its claims against the codebase, enrich it with missing details, and post one structured triage comment. Use when triaging and labeling incoming issues, not to fix them.4compatibility: Requires git, gh CLI, and internet access5user-invocable: true6metadata:7 source: https://skillmd.com/skills/stbenjam/skillsaw-issue-triage8 author: stbenjam9 version: "1.0"10---1112# skillsaw Issue Triage1314Triage a single open issue on the **skillsaw** linter. Check what kind of15issue it is, check whether its claims hold up against the actual code, fill in16the details it is missing, review the evidence, and leave one triage17comment. This skill **triages** issues — never fix them here (that job belongs to `skillsaw-issue-solver`).1819Read the detailed evaluation checklist for each classification in `references/`,20and read **only** the checklist for the class the issue falls into (progressive disclosure).21Keep this file lean and pull the checklist in on demand.2223## Step 1 — Read the Issue2425Run this for the issue number you were given:2627```bash28gh issue view <number> --json number,title,body,labels,author,comments,createdAt29```3031Read the title, body, and every comment before judging anything. Note the32skillsaw version the reporter names (or none), and check any config, command, or file content they pasted.3334## Step 2 — Classify3536Set exactly one primary class. When an issue spans two, pick the one that determines the next action and note the secondary in the comment.3738| Class | The issue is… | Evaluation checklist |39|---|---|---|40| `bug` | A claim that skillsaw behaves incorrectly — wrong violation, crash, false positive/negative, bad autofix | [`references/bug-evaluation.md`](references/bug-evaluation.md) |41| `feature` | A request for new behavior — a new rule, flag, config option, output format, or tool/format support | [`references/feature-evaluation.md`](references/feature-evaluation.md) |42| `documentation` | Docs are missing, wrong, or unclear (README, skillsaw.org, rule docs) — code behavior is not disputed | [`references/other-evaluation.md`](references/other-evaluation.md) |43| `question` | A usage/support question, not a defect or request | [`references/other-evaluation.md`](references/other-evaluation.md) |44| `other` | Duplicate, invalid, spam, out-of-scope, or needs-more-info | [`references/other-evaluation.md`](references/other-evaluation.md) |4546Write the class and a one-sentence rationale.4748## Step 3 — Verify Accuracy4950**Read the checklist for the chosen class now** (`references/*.md`) and work it.51Check whether the issue is *accurate* — do its claims match how skillsaw actually behaves?5253- For a **bug**: run the repro against the current code. Trace the cited behavior54 to the responsible rule or `src/` module, then verify it. A bug you cannot55 reproduce, or that describes intended behavior, is not confirmed — always say so.56- For a **feature**: check whether it already exists, whether it fits skillsaw's57 scope (core vs a rule plugin), and verify it would not break existing users.58- For **documentation / question / other**: verify the underlying facts before agreeing or redirecting.5960Cite what you checked with `file:line` references and command output — never assert a conclusion you did not verify.6162## Step 4 — Enrich6364Add the details the issue is missing so it is actionable without a round-trip:6566- **Reproduction**: write a minimal repro (config + input file + command + observed vs expected) when the reporter left one out and you can construct one.67- **Locus**: include the rule ID, file, and line most relevant to the issue.68- **Version / environment**: include the version the behavior was verified against, and whether it still reproduces on `main`.69- **Related work**: review duplicate or related issues and any open PR that already touches this (`gh issue list` / `gh pr list --search`).70- **Suggested labels**: include labels (e.g. `bug`, `enhancement`, `documentation`, `question`, `duplicate`, `needs-info`, `good-first-issue`), but never apply them unless asked.7172## Step 5 — Decide the Recommendation7374Set exactly one recommendation — this is the headline of the triage comment:7576| Recommendation | When |77|---|---|78| 🛠️ **FIX — REPRODUCED** | A real defect you reproduced or confirmed against the code (a genuinely wrong or missing doc counts here too). |79| ✨ **IMPLEMENT — GOOD IDEA** | An in-scope feature worth building into skillsaw core. |80| 🔌 **PLUGIN** | In skillsaw's domain but niche / single-vendor — belongs in a rule plugin, not core. Link `skillsaw.org/plugins/`. |81| ⛔ **REJECT** | Out of scope, not reproduced, works-as-intended, invalid, duplicate, or answered. |8283Follow the class checklist to decide: a bug that reproduces → FIX,84one that doesn't → REJECT; for a feature, follow the domain gate in85[`references/feature-evaluation.md`](references/feature-evaluation.md) (out of domain → REJECT, niche → PLUGIN,86broadly useful → IMPLEMENT).8788## Step 6 — Post One Triage Comment8990Read [`references/triage-template.md`](references/triage-template.md), then post it as exactly ONE comment:9192```bash93gh issue comment <number> --body "$(cat <<'TRIAGE'94<rendered triage>95TRIAGE96)"97```9899This skill is advisory: keep its output a recommendation for a maintainer. Post100the triage comment on your own initiative, but never close, reassign, or label101the issue yourself — always leave that to a human. Follow one exception only: a102label action the invoking context directs — for instance, keep clearing an103automation's own trigger label once you post the comment. Always carry that out.