bug-submit

Files triaged bug reports as local markdown folders with screenshots and an HTML tracker.

Updated May 26, 2026
One-click install
npx skills add https://github.com/cagriy/dev-skills --skill bug-submit-cagriy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-submit
Source: https://github.com/cagriy/dev-skills/tree/main/skills/bug-submit
Command: npx skills add https://github.com/cagriy/dev-skills --skill bug-submit-cagriy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns a vague verbal bug report into a structured, numbered, triaged record stored directly in the repository, so defects are captured with context instead of being lost in chat or hastily written tickets. ## Core Features & Use Cases - Structured local bug filing: Creates a bugs/bug-N-<slug>/ folder with a markdown report containing description, reproduction steps, severity, and a triage section grounded in a quick read of the relevant code paths. - Screenshot attachment handling: Copies images pasted into the conversation or passed as paths into the bug folder and links them relatively in the report, with a confirmation gate for potentially sensitive files. - Automatic tracker generation: Regenerates a repo-wide bugs/bugs-tracker.html Issues view listing open and archived bugs via the delegated bug-tracker-render skill. - Use Case: While testing your app you notice the login button does nothing on Safari. Describe it in one sentence, paste a screenshot, and the skill files bugs/bug-4-login-button-does-nothing-on-safari/ with a triaged report and updates the tracker. ## Quick Start Ask the assistant to file a bug report describing what broke, what you expected, and attach any screenshots of the problem.

Frequently Asked Questions about bug-submit

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

FAQPage Schema
How do I file a bug report inside my git repository?

Describe the bug in chat or invoke /bug-submit with a description and optional image paths. The skill creates a bugs/bug-N-slug/ folder containing a markdown report with description, severity, and triage, then updates the HTML tracker.

How do I attach screenshots to a bug report?

Paste images directly into the chat or pass image file paths as arguments. The skill detects paths surfaced via [Image: source: path] annotations, validates them, and copies the files into the bug folder with relative links in the report.

Does this create GitHub issues or push anything remote?

No. Everything stays local under the repository's bugs/ directory. The skill never creates GitHub issues, commits, pushes, or uploads images anywhere; it only writes the bug folder and regenerates the local HTML tracker.

How are bug numbers assigned and kept unique?

The skill scans both bugs/ and bugs/archive/ for existing bug-N folders, takes the numeric maximum, and adds one. Scanning the archive ensures numbers are never reused after a resolved bug is moved out of the active folder.

What happens if my bug description is too vague?

The skill pauses and asks one clarifying chat message requesting a proper description and screenshots before creating anything. If you still provide nothing substantive, it stops cleanly with no folder or files created.

Can it handle sensitive screenshots or credentials in reports?

Yes. Images that look sensitive require an explicit 'proceed' confirmation before being copied into the repo, and any credentials detected in the description are redacted from the report with a warning before writing.