09-defect

09-defect is a skill for Claude Code from ai-driven-dev/framework. It costs 49 tokens per session (267 once invoked), scanned A, original, MIT.

A workflow for recording and managing a defect, meaning an observed mismatch between a product and what it should do. It captures evidence, impact, readiness, and status.

In plain words
What is it for?
Use it to report, assess, link, order, change the status of, or verify a defect.
Why use it?
It gives a product problem a clear record without mixing the report with a diagnosis or proposed fix.

Skill for Claude Code

Written for Claude Code: argument-hint in frontmatter.

Part of the aidd-pm plugin — 10 skills shipped together

Good fit Use it to report, assess, link, order, change the status of, or verify a defect.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ai-driven-dev/framework/09-defect
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add ai-driven-dev/framework --skill 09-defect
Clone the repo
git clone --depth 1 https://github.com/ai-driven-dev/framework

Made for: Claude Code.

Or install aidd-pm, the plugin that ships this one along with the rest of its 10 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for 09-defect

README.md
[![agentmods](https://agentmods.dev/badge/skills/ai-driven-dev/framework/09-defect/github.svg)](https://agentmods.dev/skills/ai-driven-dev/framework/09-defect)
Your own site
<a href="https://agentmods.dev/skills/ai-driven-dev/framework/09-defect"><img src="https://agentmods.dev/badge/skills/ai-driven-dev/framework/09-defect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for 09-defect

Your own site · 80×15
<a href="https://agentmods.dev/skills/ai-driven-dev/framework/09-defect"><img src="https://agentmods.dev/badge/skills/ai-driven-dev/framework/09-defect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 267 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00049 $0.00267
Opus 5.5 $0.00020 $0.00107
Sonnet 5.5 $0.00010 $0.00053
Haiku 4.5 $0.00005 $0.00027

Measured 1mo ago against content hash 2c91a61f33fd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

09-defect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/aidd-pm/skills/09-defect/SKILL.md · 36 lines

What it actually says

Defect

flowchart LR
  source([report or Defect]) --> capture --> assess --> finalize
  source -->|"already persisted"| finalize
  assess -->|"revise"| capture
  finalize -->|"revise"| capture
  finalize -->|"authorized"| done([Defect])

Actions

Run the flow above. Read only the next action file.

Action Does
capture frame one observed product mismatch
assess establish evidence, impact, and readiness
finalize persist or transition the Defect

Transversal rules

  • Keep product and lifecycle decisions with the user.
  • Separate evidence, decisions, and assumptions.
  • Preserve source links and existing edits.
  • Ask natural questions; never expose actions, references, or unchanged state.
  • Require explicit approval or caller-provided bounded authority before any write.
  • Record the mismatch; never diagnose or implement its fix.
Files

What ships with it

10 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 36 lines · 49 tokens per session scan A 2c91a61f33fd

Subscribe to this mod's changes

09-defect is a skill published in the GitHub repository ai-driven-dev/framework (522 stars, last pushed yesterday), licensed MIT. It adds 49 tokens to every session and 267 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

awesome-ai-agents-curation

Help founders prepare evidence-backed AI agent project submissions and help maintainers triage project issues and pull requests for the Awesome AI Agents list.

slavakurilyak/awesome-ai-agents · 34 tokens

ship-it

Worktree-side implementation orchestrator for an OpenSpec change. Idempotent: gates automated scenarios on filesystem reality, owns the red-test fix loop, runs the docker harness with always-teardown, then drives ship-change inline. Escape hatch writes SHIPITBLOCKED.md. Runnable headless. Triggers: "ship it", "build…

BlackBeltTechnology/pi-agent-dashboard · 92 tokens

task-graph

Execute an approved multi-task plan as a verified DAG with @taskgraph — parallel squad workers per task, validation gates the engine runs itself, and an independent reviewer verdict before any task counts as done. Use for deliveries of 5+ tasks with real independence between them; for smaller work dispatch workers…

diillson/chatcli · 69 tokens

linear

Manage Linear issues from the terminal via the official GraphQL API and the user's API key — list/search issues, create issues, update status/assignee, add comments. Use when asked to "create a Linear issue", "what's assigned to me in Linear", "move this issue to done", "comment on LIN-123".

diillson/chatcli · 69 tokens

notion

Read and write Notion — search pages/databases, query a database, create pages, append blocks — via the official Notion REST API and the user's own integration token. Use when asked to "add to Notion", "find in my Notion", "create a Notion page", "update my Notion database".

diillson/chatcli · 69 tokens

caixun-work-hours

A work-hours reporting assistant for RichPMS, a project time-tracking system. It turns conversation details, code records, or your description into a daily report, lets you confirm it, and then saves or submits it.

nexus-research-lab/nexus · 77 tokens