filing-bug-reports
Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue. Use when the user says 'file a bug', 'write a bug report', 'report this issue', or asks to document a defect for handoff.
npx skills add matlab/simulink-agentic-toolkit --skill filing-bug-reports --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Filing Bug Reports Generate a self-contained bug report as a Markdown file that gives a receiving developer everything needed to reproduce the issue — without prescribing root cause or solution. ## When to Use - User asks to file, write, or document a bug - User wants to hand off a defect for another developer to investigate - User wants a reproducible record of unexpected behavior ## When NOT to Use - User wants to debug and fix the issue themselves right now — just help them directly - User wants a design review or code review — use `code-review` skill instead ## Output Conventions - **File:** `issues/BUG-<NNN>-<slug>.md` (next available number, kebab-case slug from title) - **Create** the `issues/` directory if it doesn't exist - **One bug per file** — never combine multiple bugs ## Workflow 1. **Reconstruct from conversation context.** You were present when the bug occurred — use your conversation history to extract: - What the user was doing (the action and intent) - What actually happened (error messages, tool output, unexpected behavior) - What was expected (infer from the user's goal — e.g., if they asked to read a model and got an error, expected behavior is a successful
- When to Use
- When NOT to Use
- Output Conventions
- Workflow
- Guardrails
- References
What does the filing-bug-reports skill do?
Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue. Use when the user says 'file a bug', 'write a bug report', 'report this issue', or asks to document a defect for handoff.
How do I install it?
Run `npx skills add matlab/simulink-agentic-toolkit --skill filing-bug-reports --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From matlab/simulink-agentic-toolkit, a repository with 903 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.