Agent skill

Filing Bug Reports

by matlab in matlab/simulink-agentic-toolkit

Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue.

Custom licenceAuto-check passedTesting & QA

Install Filing Bug Reports

skills CLI
$ npx skills add matlab/simulink-agentic-toolkit --skill filing-bug-reports -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install matlab/simulink-agentic-toolkit filing-bug-reports --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/matlab/simulink-agentic-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills-catalog/model-based-design-core/filing-bug-reports .claude/skills/filing-bug-reports && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
filing-bug-reports
GitHub stars
1.2k
Token cost
~1.9k tokens
SKILL.md length
1,024 words
Files
3 (incl. assets)
Skills in repo
43
Repo updated
First seen
Licence
Custom licence

At a glance

Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue.

  • Works in 7 steps: Reconstruct from conversation context.… → Gather environment details… → Reproduce the bug. Re-run the failing… → …
  • The user says file a bug
  • SKILL.md covers When to Use, When NOT to Use, Output Conventions and Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Filing Bug Reports is an agent skill from matlab/simulink-agentic-toolkit. 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.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including assets (for example `assets/bug-report-template.md` and `manifest.yaml`).

It sits in Testing & QA, covering QA and bug reports. The repository describes itself as: The Simulink Agentic Toolkit gives your AI agent both the tools and the expertise to work effectively with Simulink and Model-Based Design.

When your agent uses it

  • The user says file a bug
  • Write a bug report
  • Report this issue
  • Asks to document a defect for handoff

Example prompts

  • “file a bug”
  • “write a bug report”
  • “report this issue”
  • “/filing-bug-reports”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Reconstruct from conversation context. You were present when the bug occurred — use your conversation history to extract
  2. Gather environment details programmatically. Don't ask the user for things you can look up
  3. Reproduce the bug. Re-run the failing operation to confirm it's reproducible and capture exact output. If it passes on retry, note it as…
  4. Shrink to a minimal reproduction. Remove every step, file, and variable that isn't needed to trigger the bug. The goal is the smallest…
  5. Ask the user ONLY for what you cannot determine
  6. Write the report using the template in assets/bug-report-template.md. Fill every required section. Mark optional sections N/A if not…
  7. Review before saving. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit c58e6ae. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Filing Bug Reports loads about 1.9k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 1,024 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,024 words (~1,910 tokens).

“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.”

— opening of SKILL.md by matlab, Custom licence
name
filing-bug-reports
license
https://www.mathworks.com/content/dam/mathworks/license/pmrl/license.md
metadata.author
MathWorks
metadata.version
1.3

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (assets) in skills-catalog/model-based-design-core/filing-bug-reports of matlab/simulink-agentic-toolkit.

  • SKILL.md
  • assets/bug-report-template.md
  • manifest.yaml

Open the folder on GitHubat commit c58e6ae

Compare with similar skills

Filing Bug Reports next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Filing Bug Reports compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Filing Bug Reports this skillmatlab/simulink-agentic-toolkit1.2k—~1.9kAutomated safety check: PassCustom licence
Dogfood Exploratory QAvercel-labs/agent-browser44k8 repos~2.7kAutomated safety check: PassApache-2.0
Codex Plugin QAcode-yeongyu/oh-my-openagent70k1 repos~1.9kAutomated safety check: PassCustom licence
DeerFlow Smoke Testbytedance/deer-flow83k—~2.5kAutomated safety check: NotesMIT
CodexBar Live QAsteipete/CodexBar22k—~1.2kAutomated safety check: PassMIT
Diagnose Playwright Failure as Product Bugappsmithorg/appsmith41k—~1.5kAutomated safety check: PassApache-2.0

Similar skills

  • Dogfood Exploratory QA

    vercel-labs/agent-browser

    Official

    Explores a web app with the agent-browser CLI to find bugs and UX problems, then writes a report with screenshots, repro videos and step-by-step reproduction for each issue.

    44k GitHub starsUsed in 8 repos~2.7k tokens
    Testing & QAAuto-check passed
  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub starsUsed in 1 repo~1.9k tokens
    Testing & QAAuto-check passed
  • DeerFlow Smoke Test

    bytedance/deer-flow

    Walks through an end-to-end smoke test of a DeerFlow deployment: pull the latest code, deploy with Docker or locally, verify services, run health checks and write a report.

    83k GitHub stars~2.5k tokensUpdated today
    Testing & QAAuto-check: notes
  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Investigates a stubbornly failing Playwright test as a possible product bug, using error output, screenshots, traces and server code, and writes a structured bug report.

    41k GitHub stars~1.5k tokensUpdated today
    Testing & QAAuto-check passed
  • Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Testing & QAAuto-check passed

More from matlab/simulink-agentic-toolkit

All 43 skills in this repo
  • Resolve Design Errors

    matlab/simulink-agentic-toolkit

    A skill your agent uses when asked to run Design Error Detection (quick defect scan), find design errors in a Simulink model, perform root cause analysis on DED findings, fix division-by-zero…

    1.2k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Simscape Write Ssc

    matlab/simulink-agentic-toolkit

    A skill your agent uses when writing or editing Simscape Language (.ssc) source files — components, domains, or functions.

    1.2k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Simulink Optimizing Embedded Code

    matlab/simulink-agentic-toolkit

    Optimizes Simulink models for Embedded Coder generated code.

    1.2k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Checking Model Compliance

    matlab/simulink-agentic-toolkit

    A skill your agent uses when the user asks to check Simulink model compliance against a standard (MISRA, MAB, JMAAB, ISO, DO, IEC, EN, CERT C/CWE, AUTOSAR, Simulink Code Inspector (SLCI)), wants to…

    1.2k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Fix Sldv Incompatibility

    matlab/simulink-agentic-toolkit

    A skill your agent uses when a Simulink model is incompatible with Simulink Design Verifier (sldvcompat returns false, or an SLDV analysis errors out on an unsupported construct) and needs to be…

    1.2k GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Simulink Collect Metrics

    matlab/simulink-agentic-toolkit

    Collect and assess quality metrics for Simulink models using the metric.Engine API.

    1.2k GitHub stars~4.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Filing Bug Reports

What does Filing Bug Reports do?

Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue. Filing Bug Reports is an agent skill from matlab/simulink-agentic-toolkit. Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue.

When should I use Filing Bug Reports?

Filing Bug Reports fits situations like: the user says file a bug; write a bug report; report this issue; asks to document a defect for handoff.

How do I install Filing Bug Reports in Claude Code?

Run `npx skills add matlab/simulink-agentic-toolkit --skill filing-bug-reports -a claude-code`. Or copy the skill folder (skills-catalog/model-based-design-core/filing-bug-reports in matlab/simulink-agentic-toolkit) into .claude/skills/filing-bug-reports in your project. Claude Code loads it when a task matches its description.

How do I install Filing Bug Reports in Codex?

Run `npx skills add matlab/simulink-agentic-toolkit --skill filing-bug-reports -a codex`. Or copy the skill folder (skills-catalog/model-based-design-core/filing-bug-reports in matlab/simulink-agentic-toolkit) into .agents/skills/filing-bug-reports in your project. Codex loads it when a task matches its description.

Can I use Filing Bug Reports in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add matlab/simulink-agentic-toolkit --skill filing-bug-reports -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/filing-bug-reports, .gemini/skills/filing-bug-reports, .github/skills/filing-bug-reports and .opencode/skills/filing-bug-reports in your project.

What does Filing Bug Reports need to run?

SKILL.md names no scripts, command-line tools or credentials: Filing Bug Reports is instructions for the agent only.

Does Filing Bug Reports access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Filing Bug Reports safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Filing Bug Reports use?

Filing Bug Reports has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Filing Bug Reports use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Filing Bug Reports?

Skills that share tags, products or a category with Filing Bug Reports: Dogfood Exploratory QA (vercel-labs/agent-browser, 44k stars), Codex Plugin QA (code-yeongyu/oh-my-openagent, 70k stars), DeerFlow Smoke Test (bytedance/deer-flow, 83k stars) and CodexBar Live QA (steipete/CodexBar, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Filing Bug Reports?

matlab (a GitHub organization) maintains it in matlab/simulink-agentic-toolkit, which has 1,199 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on October 7, 2026.

Source: matlab/simulink-agentic-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.