speckit-bug-assess

Assess bug reports against the codebase and write structured assessment files.

1|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill speckit-bug-assess-igorganapolsky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-bug-assess
Source: https://github.com/IgorGanapolsky/Random-Timer/tree/main/.cursor/skills/speckit-bug-assess
Command: npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill speckit-bug-assess-igorganapolsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Triaging incoming bug reports manually is slow and inconsistent: engineers must read the report, hunt for the relevant code, judge severity, and draft a fix plan before any work begins. This Skill automates that triage by ingesting a bug report (pasted text or a URL), locating suspected code paths, assigning a verdict and severity, and writing a standardized assessment file that downstream fix and test commands consume. ## Core Features & Use Cases - Bug report ingestion: Accepts pasted text, URLs (GitHub, GitLab, Jira, Sentry, Stack Overflow), or a mix, with a strict URL trust policy that refuses private, loopback, and metadata endpoints. - Codebase triage: Searches the repository for symbols, error strings, and file paths mentioned in the report, then produces a root-cause hypothesis with a confidence level. - Structured output: Writes .specify/bugs/<slug>/assessment.md containing verdict, severity, reproduction steps, suspected code paths, proposed remediation, risks, and open questions. - Use Case: A maintainer pastes a GitHub issue URL reporting a login timeout; the Skill fetches the issue, locates the auth handler code, rates it high severity, and writes an assessment ready for the /speckit-bug-fix step. ## Quick Start Ask the assistant to assess a bug by providing the issue URL or pasting the error text, for example: assess this bug report https://github.com/org/repo/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 verdict and severity, and writes an assessment file to .specify/bugs/<slug>/assessment.md for downstream fix commands.

How to assess a GitHub issue without leaving my editor?

Pass the GitHub issue URL as input. The Skill fetches the page under an allowlist trust policy covering github.com, gitlab.com, Jira, Linear, Sentry, and Stack Overflow, extracts the report content, and produces the assessment in your repository.

Does the bug assessment fetch any URL I give it?

No. It refuses non-HTTP schemes, localhost, private RFC1918 ranges, and cloud metadata endpoints outright. Recognized public issue trackers are fetched directly; unrecognized hosts require explicit user confirmation in interactive mode or are skipped in automated mode.

What project structure does the bug assessment workflow require?

It requires a spec-kit project with a .specify directory. Each bug gets its own directory at .specify/bugs/<slug>/ containing the generated assessment.md, which downstream commands like /speckit-bug-fix and /speckit-bug-test consume.

Can the assessment modify my source code while triaging?

No. The Skill only reads the codebase and writes inside .specify/bugs/<slug>/. It never modifies source files, never overwrites an existing assessment without confirmation, and marks unknowns as [NEEDS CLARIFICATION] instead of guessing.