dev-report

Drafts and iterates structured bugreport.md files for local development defects.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/GinoCanessa/dotnet-fhir-packages --skill dev-report-ginocanessa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-report
Source: https://github.com/GinoCanessa/dotnet-fhir-packages/tree/main/.github/skills/dev-report
Command: npx skills add https://github.com/GinoCanessa/dotnet-fhir-packages --skill dev-report-ginocanessa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Capturing a software defect with enough rigor for an engineering lead to act on it is tedious and inconsistent. This Skill acts as a staff-level Tech Lead that turns raw error messages, logs, and observations into a structured bugreport.md with separated symptoms, hypotheses, repro steps, and blast radius. ## Core Features & Use Cases - Structured bug reports: Produces a standardized markdown report with sections for Summary, Environment, Symptoms, Steps to Reproduce, Evidence, Hypotheses, Workarounds, Blast Radius, and Open Questions. - Slot-based file management: Accepts a full path or a short slot number that expands to scratch/[MMDD]-[##]/bugreport.md, keeping drafts gitignored and out of the repo. - GitHub issue seeding: Optionally fetches an existing issue via gh issue view to seed the draft, and offers a hand-off to publish or plan once the report reaches Ready-for-plan status. - Interactive open-questions walkthrough: After each pass, offers to walk unresolved questions one at a time with recommended answers, applying each answer to the document immediately. - Use Case: You hit a failing restore in your FHIR package CLI. Invoke the Skill with slot 3 and paste the stack trace; it creates scratch/0423-03/bugreport.md, ranks likely root causes, and asks targeted questions to pin down the repro. ## Quick Start Ask the assistant to draft a bug report for slot 3 using the error message and stack trace you paste in.

Frequently Asked Questions about dev-report

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

FAQPage Schema
How do I write a structured bug report for a software defect?

Provide a target file path or slot number plus your raw description of the defect, such as an error message or log excerpt. The Skill writes a bugreport.md with sections for symptoms, repro steps, evidence, ranked hypotheses, workarounds, and blast radius.

How do I create a bug report from an existing GitHub issue?

Pass an issue reference as #N, gh#N, or a full issue URL along with your target. The Skill fetches it with gh issue view and seeds the report title, summary, labels, and URL, then applies its own analysis on top.

Where does the dev-report skill store its output files?

Reports are written under the gitignored scratch/ directory as scratch/<MMDD>-<##>/bugreport.md when you give a slot number, or to any full path you provide. They are local drafts and are never committed.

Can the skill fix the bug or write an implementation plan?

No. It deliberately stays in the Tech Lead role: it scopes the problem and frames hypotheses, but implementation plans belong to dev-plan and code changes belong to dev-do. It may read referenced files to refine hypotheses.

What happens when the bug report has unanswered open questions?

After each pass the Skill offers an interactive walkthrough of the Open Questions section, asking one question at a time with up to three candidate answers and one recommendation. You can decline and edit the file yourself instead.