skills.rest
Esri
EsriOFFICIAL
Explore all skills by this author →
WebsiteGitHub

speckit-bug-assess

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

32|9|Updated Feb 2, 2024
Search Tags:#root cause analysis#remediation#github issues#spec-kit#bug triage#severity#issue assessment
One-click install
npx skills add https://github.com/Esri/arcgis-gitops --skill speckit-bug-assess-esri
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-bug-assess
Source: https://github.com/Esri/arcgis-gitops/tree/main/.github/skills/speckit-bug-assess
Command: npx skills add https://github.com/Esri/arcgis-gitops --skill speckit-bug-assess-esri

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. This Skill automates that triage by analyzing a pasted bug report or issue URL against the codebase and producing a structured assessment file. ## Core Features & Use Cases - Bug Report Ingestion: Accepts pasted text, stack traces, or URLs to GitHub/GitLab/Jira/Sentry issues, with a strict URL trust policy that refuses private-network and non-HTTP(S) targets. - Codebase Correlation: Searches the repository for symbols, error strings, and file paths mentioned in the report to identify suspected root-cause locations. - Structured Assessment Output: Writes a verdict, severity rating, root-cause hypothesis, remediation proposal, and risk list to .specify/bugs/<slug>/assessment.md for downstream fix and test commands. - Use Case: A maintainer receives a GitHub issue reporting a 500 error on login. They run the Skill with the issue URL, and it fetches the report, locates the authentication code paths, rates the bug as high severity, and writes an assessment ready for the fix workflow. ## Quick Start Assess this bug report against the codebase and write an assessment: https://github.com/myorg/myrepo/issues/123

Frequently Asked Questions about speckit-bug-assess

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

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

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

How to triage a GitHub issue with an AI assistant?▼

Pass the GitHub issue URL as input. The Skill fetches the issue content under a URL trust policy, correlates it with repository code, and produces an assessment with reproduction steps, root-cause hypothesis, and a proposed remediation.

Does the bug assessment modify my source code?▼

No. The Skill is read-only with respect to source files. It only creates or writes files inside .specify/bugs/<slug>/, and it refuses to overwrite an existing assessment.md without confirmation.

What project structure is required for speckit-bug-assess?▼

It requires a spec-kit project structure with a .specify/ directory at the repository root. Bug assessments are stored in per-bug directories under .specify/bugs/<slug>/ for consumption by downstream commands.

Which URLs can the bug assessment fetch safely?▼

It fetches public issue trackers like github.com, gitlab.com, atlassian.net, and sentry.io without prompting. It refuses private IP ranges, localhost, cloud metadata endpoints, and non-HTTP(S) schemes, and asks before fetching unrecognized hosts.

What happens if the bug report is unclear or invalid?▼

The Skill marks unknowns as [NEEDS CLARIFICATION] rather than guessing. If the report is empty, unrelated, or spam, it sets the verdict to invalid with a clear reason and stops without proposing a fix.

Related Skills

Explore More Software Engineering Skills→
ilove323ilove323

debug

Diagnose software failures and generate a structured debugging report.

Community
Intermediate
mykaarmamykaarma

systematic-debugging

Identify root causes of bugs and test failures before proposing fixes.

Official
Intermediate
0xHoneyJar0xHoneyJar

triage

Triages user signals and error reports to identify affected code paths and estimate blast radius.

Official
Intermediate
ConavaConava
2

debug

Deploy a debugger agent to analyze bugs and produce root-cause reports.

Community
Advanced