speckit-bug-assess

Assess bug reports against the codebase and write structured remediation assessments.

Updated May 28, 2026
One-click install
npx skills add https://github.com/whw23/PingoGate --skill speckit-bug-assess-whw23
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-bug-assess
Source: https://github.com/whw23/PingoGate/tree/main/.claude/skills/speckit-bug-assess
Command: npx skills add https://github.com/whw23/PingoGate --skill speckit-bug-assess-whw23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Triaging incoming bug reports is slow and inconsistent: engineers must manually reproduce symptoms, hunt for the responsible code, judge severity, and draft a fix plan. This Skill standardizes that triage by turning a pasted report or issue URL into a structured assessment file that downstream fix and test commands can consume. ## Core Features & Use Cases - Bug ingestion from text or URL: Accepts pasted stack traces, issue text, or links to GitHub, GitLab, Jira, Sentry, and similar sources, with a strict URL trust policy that refuses private-network and non-HTTP targets. - Codebase grounding: Searches the repository for the symbols, file paths, and error strings mentioned in the report to identify suspected root-cause locations. - Structured assessment output: Writes a verdict, severity rating, reproduction steps, root-cause hypothesis, and remediation proposal to .specify/bugs/<slug>/assessment.md for use by /speckit-bug-fix and /speckit-bug-test. - Use Case: A maintainer pastes a GitHub issue link about a login timeout; the Skill fetches the issue, locates the relevant auth code paths, rates the bug as high severity, and produces an assessment with a proposed fix and tests to add. ## Quick Start Assess this bug report against the codebase and write an assessment: https://github.com/myorg/myrepo/issues/42

Frequently Asked Questions about speckit-bug-assess

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage a bug report against my codebase automatically?▼

Provide the bug report as pasted text or a URL, and the Skill summarizes the symptom, searches the codebase for suspected code paths, assigns a severity, and writes a structured assessment to .specify/bugs/<slug>/assessment.md.

How to assess a GitHub issue without leaving my project?▼

Pass the GitHub issue URL as input. The host is on the fetch allowlist, so the page content is retrieved, merged with any pasted text, and treated as untrusted data while the assessment is built from your local code.

Does bug assessment require a spec-kit project structure?▼

Yes, the Skill requires a .specify directory in the project. Each bug gets its own directory under .specify/bugs/<slug>/ where the assessment.md file is written for downstream commands to consume.

Can I fetch bug reports from private or internal URLs?▼

No. The URL trust policy refuses loopback, RFC1918 private addresses, cloud metadata endpoints, and non-HTTP schemes outright. Unrecognized public hosts require explicit user confirmation in interactive mode.

What happens if the bug slug directory already exists?▼

In interactive mode the Skill asks before overwriting an existing assessment. In automated mode it refuses and generates a unique slug by appending a numeric suffix or date, never overwriting an existing bug directory.