writing-defect-reports SKILL.md skillA

writing-defect-reports from kajisho5/ffmpeg-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kajisho5/ffmpeg-skill/writing-defect-reports@git:20260906.24c1610

Pins git:20260906.24c1610 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kajisho5/ffmpeg-skill
Path
.claude/skills/defect-reports/SKILL.md
Versions recorded
1
Latest version
git:20260906.24c1610, committed Sep 6, 2026
Size
12,200 bytes
Repository stars
2,026
License
MIT

Establish a finding before you publish it, and correct it after — headlines that overstate what actually reproduces at the layer a user sees, reporting code that no entry point can reach or that is already dead, filing a caveat the project's own records already answered, re-verifying your prior notes against the tree instead of against the note, choosing the narrowest injection point that reproduces a failure without breaking the run first, capturing probe output a harness swallows, and…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Writing Defect Reports

A report is a claim, and it is read by people who will not re-derive it. The cost
of an overstated one is not embarrassment — it is a maintainer spending an
afternoon on a premise that does not hold, or a "fix" landing for a failure mode
that never occurred. The techniques for *finding* a defect live in
**verifying-external-behavior** (also in this repo's `.claude/skills/`). This
skill is about the step between finding one and publishing it.

The rule underneath all of it: **publish the claim you actually measured, at the
layer you measured it.**

## The anomaly is real; the headline may not be

The common failure is not a fabricated bug. It is a genuine internal oddity
promoted one layer too far.

You notice that a helper returns a degenerate value for a small sample, trace it
into a scoring path, and write the report as *"short inputs are wrongly flagged."*
Then you run real short inputs through the public entry point and the flag never
sets — a downstream threshold absorbs the degenerate value, and the only visible
effect is noise in a secondary per-feature list. The internal oddity is worth
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kajisho5/ffmpeg-skill/writing-defect-reports@sha256:774bb1a56a01efbc

The line at the top of this page pins the label git:20260906.24c1610, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_i4xh7vfcvo4tba2f.svg)](https://markdownregistry.com/a/art_i4xh7vfcvo4tba2f)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 6, 2026.

versioncommittedcommitsizeaudit
git:20260906.24c1610 latest2026-09-06 24c1610 12,200 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12200 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kajisho5/ffmpeg-skill · 2,026 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i4xh7vfcvo4tba2f
GET https://markdownregistry.com/api/v1/resolve?ref=kajisho5/ffmpeg-skill/writing-defect-reports
GET https://markdownregistry.com/api/v1/blob/774bb1a56a01efbcb6ba8e2c925fc416ac3477d8167a974a40d794054359b720

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kajisho5/ffmpeg-skill

shipping-build-artifacts SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/build-artifacts/SKILL.md · Make the build step a real gate on what you actually distribute — build scripts that warn and exit 0 on a missing…
git:20260906.24c1610 · audit B · 2,026 stars
ci-pipeline-synthesizer SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/ci-pipeline-synthesizer/SKILL.md · Generate GitHub Actions CI/CD pipeline configurations for automated building and testing of library and package…
git:20260907.d021232 · audit A · 2,026 stars
reviewing-ffmpeg-skill-changes SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/code-review/SKILL.md · Review a change to the ffmpeg-skill repository for the failures its own contract makes possible — a claim in a result…
git:20260922.1a77112 · audit A · 2,026 stars
concurrent-branches SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/concurrent-branches/SKILL.md · Resolve conflicts and merges when several branches are open against one repo at the same time — the hotspot files every…
git:20260906.24c1610 · audit A · 2,026 stars
shipping-across-surfaces SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/cross-surface-changes/SKILL.md · Land a change everywhere the same fact is stated — enumerating the full surface inventory (landing copy, docs…
git:20260906.24c1610 · audit A · 2,026 stars
guarding-destructive-operations SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/destructive-operations/SKILL.md · Add and review preconditions on operations that delete, overwrite, rewrite history, or resolve a caller-supplied name…
git:20260906.24c1610 · audit A · 2,026 stars
keeping-git-repos-clean SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/git-hygiene/SKILL.md · Prevents, detects, and remediates files that should never be committed — secrets (.env, API tokens, hardcoded…
git:20260906.24c1610 · audit F · 2,026 stars
running-github-actions-efficiently SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/github-actions/SKILL.md · Cut GitHub Actions minutes and wall-clock time without losing coverage — the OS billing multiplier (macOS 10x / Windows…
git:20260906.24c1610 · audit A · 2,026 stars
building-python-mcp-servers SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/mcp-server-design/SKILL.md · Builds robust Python MCP (Model Context Protocol) servers with FastMCP — tool design, error contracts, event-loop-safe…
git:20260906.24c1610 · audit A · 2,026 stars
managing-python-releases SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/release-management/SKILL.md · Manages Python library releases including semantic versioning, changelog maintenance (Keep a Changelog format), release…
git:20260906.24c1610 · audit A · 2,026 stars
reproducing-ci-locally SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/reproducing-ci-locally/SKILL.md · Run the CI gate on your machine so it agrees with the runner — deriving the exact command, paths, markers, and env from…
git:20260906.24c1610 · audit A · 2,026 stars
verifying-external-behavior SKILL.md skill
kajisho5/ffmpeg-skill · .claude/skills/verifying-external-behavior/SKILL.md · Confirms what a third-party library, remote API, build backend, or scraped document actually does before writing code…
git:20260906.24c1610 · audit A · 2,026 stars

Every file in kajisho5/ffmpeg-skill

Browse by kind, by grade A, or by owner.