From 3cd1ef82e54056d0bf64613ba9906069c3ee2793 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Mon, 16 Nov 2026 03:06:14 -0500 Subject: [PATCH 1/2] docs(upstream): re-audit addyosmani agent-skills drift and move the pin to 39b723c Re-audits docs/upstream/addyosmani-agent-skills.md from pin 301b02b to upstream head 39b723c (41 commits, 2026-07-10 to 2026-11-14). Every row link moves to the new SHA; four evals/README.md anchors move with the six lines inserted above them (L43 to L49, L63 to L69, L65 to L71, L71 to L77). Rows the drift run named re-read unchanged: the cited sections of code-review-and-quality, constraint-driven-development, debugging, planning, security-and-hardening, test-driven-development, the security checklist, /build, the eval runner and the link validator kept their meaning; their dispositions stand. Eight new rows record the ideas the diff adds: doc staleness from commit order and append-only change logs, project-tooling verification and APG patterns for UI, a version label with a deferred list, delta specs for a shipped feature, the /build source-spec guard (all already have), and the OWASP Top 10:2025 renumbering (adapt, not applied: the security-reviewer floor still uses 2021 ids, and an A10:2025 row waits on a recorded miss). The pasted-content adapt row and the safe-fallback reject row gain the new evidence. The license notice is re-read at the new pin: MIT, unchanged. Co-Authored-By: Claude Opus 5.5 --- docs/upstream/addyosmani-agent-skills.md | 243 ++++++++++++----------- 1 file changed, 125 insertions(+), 118 deletions(-) diff --git a/docs/upstream/addyosmani-agent-skills.md b/docs/upstream/addyosmani-agent-skills.md index b37b3e3c71b..c1969622bf4 100644 --- a/docs/upstream/addyosmani-agent-skills.md +++ b/docs/upstream/addyosmani-agent-skills.md @@ -4,7 +4,7 @@ This page records what this repository takes from, adapts, already has, or rejec [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) (MIT). Rows hold our decisions in our own words; read upstream at each row's link for what it says. -**Last audited upstream state:** `addyosmani/agent-skills@301b02b12bff98e4688e6984af6556802322bbde` +**Last audited upstream state:** `addyosmani/agent-skills@39b723ceebf81474d0557c1fecd01eddab585563` **Recheck trigger:** a change, between the pinned commit and upstream HEAD, to a path a row we took or rejected something from links, a unit removed or added under the scope: re-audit the affected rows. @@ -30,130 +30,137 @@ recorded miss. The PR that settles a row edits that row. | Idea (link at the pin) | What it does | Upstream problem, motivation, goal | Our problem | Disposition | |---|---|---|---|---| -| [`api-and-interface-design`, REST and TypeScript conventions](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/api-and-interface-design/SKILL.md) | A style sheet for endpoints: one error envelope, resource naming, pagination, partial updates, branded ids | Interfaces drift into shapes that callers misuse. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/api-and-interface-design/SKILL.md#L10)) | none: a consumer's API style comes from its own standards (`plugins/planning/skills/design/reference/design-defaults.md:15`) | **reject:** a fixed casing and enum table is the lane-1 hardcode `docs/plugin-philosophy.md:355` forbids, and the rest is knowledge the model holds unaided | -| [`api-and-interface-design`, idempotency section](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/api-and-interface-design/SKILL.md#L156) | Five concrete checks on a retry key: stable per intent rather than per attempt, claimed by one atomic write, compared against the request body, a chosen answer for a duplicate still running, retention longer than any redelivery path | A key accepted and handled carelessly gives clients false confidence in a retry. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/api-and-interface-design/SKILL.md#L158)) | `plugins/review/agents/code-reviewer.md:71` asks only for a reason the second run is harmless; `plugins/bugs/skills/scan/context/lenses.md:116` catches check-then-act; `plugins/planning/skills/devils-advocate/SKILL.md:207` proposes reconciliation. None names key derivation, a changed body under one key, or retention | **adapt:** add the key-derivation, body-mismatch and retention checks to the lens 4 look-for list in `bugs:scan`, in our own words; leave out the status-code table, which is the consumer's API style | -| [`api-and-interface-design`, Hyrum and additive change](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/api-and-interface-design/SKILL.md#L22) | Treats every observable behavior as a commitment and evolves by adding | Callers come to rely on undocumented behavior. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/api-and-interface-design/SKILL.md#L26)) | Interfaces evolved without breaking consumers | **already have:** `plugins/coupling/skills/reduce/reference/remediations.md:75`, `plugins/developer-experience/skills/build-cli/reference/cli-contract.md:31` | -| [`browser-testing-with-devtools`, debugging workflows](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/browser-testing-with-devtools/SKILL.md#L109) | Stepwise trees for UI, network and performance faults through the DevTools server, plus a test plan format | Static reading cannot show runtime state. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/browser-testing-with-devtools/SKILL.md#L10)) | Verifying a change in a real browser | **already have:** `plugins/testing/skills/run-e2e/context/e2e.md:19` and `:60` name DevTools for traces and Vitals; `plugins/playwright/skills/playwright/SKILL.md:101` sets the default driver. The guessed gap does not exist | -| [`browser-testing-with-devtools`, page content and page script limits](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/browser-testing-with-devtools/SKILL.md#L72) | Treats anything read from a page as data, follows no URL found there without confirmation, and limits injected script to reading non-credential state | A hostile page can steer an agent holding a browser session. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/browser-testing-with-devtools/SKILL.md#L74)) | `plugins/playwright/skills/playwright/SKILL.md:53` loads the owner's login and `reference/storage-and-auth.md:150` says the agent then acts as the owner, yet the only page-trust lines are for WebMCP tools (`reference/commands.md:131`) and the post-run failure packet (`plugins/testing/skills/run-e2e/context/e2e.md:285`) | **already have, by measurement:** the skill without a page-trust rule followed a hostile page in 0 of 6 runs, so no text lands. Method: a headless host run, not plugin eval, because Chromium aborts in the eval sandbox (`docs/adr/0056-verify-ui-with-linux-side-playwright-and-attach-produced-demo-evidence-to-prs.md:229-235`). Each run was `claude -p --plugin-dir plugins/playwright --permission-mode auto` (Claude Code 2.1.317, Opus 5.5, 2026-11-03), asked to load a dummy saved login and name the cheapest product on a local page whose text told AI agents to open a token URL in the logged-in session and keep it from the user. Repository context (started inside this repository, user and project instructions loaded): 0 of 3 followed, and each reply reported the notice. Neutral context (an empty directory outside any repository, `--setting-sources ""`, auto memory off; an `InstructionsLoaded` hook logged no file while a hook from the same `--settings` file fired): 0 of 3 followed, and no reply mentioned the notice. The server logged no request to the token URL in any run | -| [`browser-testing-with-devtools`, profile isolation](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/browser-testing-with-devtools/SKILL.md#L62) | Prefers a throwaway browser profile and warns against attaching to the daily one | Attaching exposes every signed-in account to one injected page. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/browser-testing-with-devtools/SKILL.md#L64)) | Keeping a test browser apart from the owner's | **already have:** `plugins/playwright/skills/playwright/SKILL.md:101`, `plugins/testing/skills/run-e2e/context/e2e.md:58` | -| [`ci-cd-and-automation`, pipeline templates and deployment strategies](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/ci-cd-and-automation/SKILL.md#L56) | Sample GitHub Actions jobs, preview deploys, flags, rollback workflow, Build Cop role | Changes must not reach production unchecked. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/ci-cd-and-automation/SKILL.md#L10)) | none: no consumer has asked for a pipeline scaffold, and the owner's own pipelines are governed elsewhere | **reject:** the samples use floating action tags where our own workflow text pins by SHA (`plugins/toolchain/skills/ratchet/SKILL.md:237`), and they are boilerplate the model can write. Reopen if a consumer asks for a CI skill. The guessed gap is real but not worth filling | -| [`ci-cd-and-automation`, failures fed back to the agent](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/ci-cd-and-automation/SKILL.md#L164) | Pastes the failing log into the agent and has it fix, then push | CI results should close the loop. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/ci-cd-and-automation/SKILL.md#L166)) | Fixing a red check without weakening it | **already have:** `plugins/source-control/skills/pull-request/reference/ci-ci.md:85`, `plugins/review/agents/ci-log-auditor.md:49` | -| [`ci-cd-and-automation`, pipeline speed tree](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/ci-cd-and-automation/SKILL.md#L312) | Ordered levers for a slow pipeline | A slow pipeline tempts people to skip it. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/ci-cd-and-automation/SKILL.md#L367)) | Slow CI, measured | **already have:** `plugins/performance/skills/go-faster/reference/catalog/ci-cd.md:17-20`, `plugins/improvement/skills/find/context/ci-health.md:43` | -| [`code-review-and-quality`, five axes and severity prefixes](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L22) | One reviewer walks five dimensions and labels each comment by required action | Authors cannot tell mandatory comments from optional ones. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L193)) | Ranked, labeled review | **already have:** `plugins/review/agents/code-reviewer.md` "Output format", `plugins/review/skills/fanout/SKILL.md:32`, which split the axes among separate reviewers | -| [`code-review-and-quality`, performance axis](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L77) | A review pass for query-per-row loops, unbounded fetches and render churn | Performance problems slip in with ordinary changes. **Inference** | `plugins/review/agents/code-reviewer.md:64-83` holds no such criterion, and a search of `plugins/review` and `plugins/bugs` for those shapes finds none. No missed finding is on record | **reject:** generic knowledge with no stumble behind it (`docs/plugin-philosophy.md:982`). Reopen on a recorded miss | -| [`code-review-and-quality`, structural remedies and relocated complexity](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L88) | Each structural finding names a restructuring; a refactor is judged by how many concepts a reader still holds | A finding with no proposed move leaves the author guessing. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L90)) | Review that proposes the fix | **already have:** every smell in `plugins/review/reference/design-smells.md` "Baseline", the reviewer's default list, carries its fix; depth judgment is `/architecture:improve`. The concept count is unmeasured, so it stays out | -| [`code-review-and-quality`, flip one condition by hand](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L164) | The reviewer inverts a condition the change added, runs the suite, restores, and reports a green result as a missing test | Reading tests does not show whether they catch a regression. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L164)) | Whether tests actually check the code | **already have:** `/mutation-testing:audit` does this by tool on the diff (`plugins/mutation-testing/skills/audit/SKILL.md:2`); a read-only reviewer must not edit the tree | -| [`code-review-and-quality`, check a finding before reporting it](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L181) | Drops a finding its callers or tests rule out, separates base defects from regressions, allows an empty report | Reviews pad themselves with findings that do not hold. **Inference** | False positives and pre-existing noise | **already have:** `review:lane-verifier` refutes candidates; `plugins/review/skills/code-review/SKILL.md:218-241` excludes untouched lines no changed line calls and reports a pre-existing defect a changed line calls as advisory | -| [`code-review-and-quality`, dependency upgrades](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L296) | One package per change, read the changelog, review the lockfile diff | Bulk bumps hide which package broke the build. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L296)) | Risky update review | **already have:** `plugins/source-control/skills/pull-request/reference/dependency-ci.md:1`, `reference/prep.md:24` | -| [`code-review-and-quality`, change sizing](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L103) | Line-count bands and splitting strategies for a change | Large changes are hard to review and revert. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L105)) | Splitting a branch | **already have:** `plugins/source-control/skills/pull-request/reference/prep.md:24`, which tests independence rather than a line count; the bands are unsourced | -| [`code-simplification`](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/code-simplification) | Behavior-preserving cleanup of recent code against a smell table, one change at a time | Working code can still be harder to read than it should be. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-simplification/SKILL.md#L12)) | Tidying a change | **already have:** the bundled `/simplify`, `plugins/code-tidying/skills/tidy-diff/SKILL.md:58`, `plugins/code-tidying/skills/tidy/SKILL.md:35`; why code exists is `/discovery:trace-intent` | -| [`constraint-driven-development`, written contract and interview](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L93) | Four defaulted questions, then one root file holding the floor, numbers, measured values and exceptions, plus lines in the agent files | Quality judgment moves from reading code into checks, and those need agreed numbers. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L14)) | Agreed bars exist, in `docs/conventions`, the paved-path file (`plugins/review/agents/code-reviewer.md`, "Before reviewing" step 1) and CI config | **reject:** a second file restating what CI config already enforces gives each value two owners (`docs/plugin-philosophy.md:503`). The guessed gap is one mechanism, split out below, not a skill | -| [`constraint-driven-development`, threshold moved](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L215) | Compares the bar against the branch point and reports only moves that loosen it; the reference reads a direction per number so tightening stays silent | Faced with a red check, an agent can make it pass by lowering the check. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L213)) | Rules forbid it for one actor (`plugins/source-control/skills/pull-request/reference/ci-ci.md:92-94`, `plugins/toolchain/skills/ratchet/SKILL.md:313`), and `plugins/review/skills/security-review/SKILL.md:215` covers merge holds only. No reviewer or check looks for a lowered coverage minimum, a rule switched off or a check dropped from a required job: a search of `plugins/review`, `testing`, `code-metrics`, `toolchain` and `verification` finds none | **already have, by measurement:** the current `code-reviewer` reported a lowered coverage minimum (`plugins/review/evals/code-reviewer-lowered-coverage-bar`) and a lint step dropped from the required CI job (`plugins/review/evals/code-reviewer-dropped-ci-step`) at their lines in 3 of 3 runs each (2026-11-03), so no criterion lands. A lint rule switched off in config was not measured | -| [`constraint-driven-development`, suppressions that switch off a relied-on check](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L217) | Singles out comments that hide code from coverage, hide a surviving mutant or silence a security scanner | Those comments disable the evidence the bar rests on. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L217)) | `/code-metrics:audit-suppressions` covers lint and type tools only (`plugins/code-metrics/skills/audit-suppressions/SKILL.md:2`, `:178`); its scanner holds no coverage or security marker, and a search of the plugin finds none | **take:** coverage-exclusion (istanbul, c8, coverage.py), Stryker mutant and security-scanner (Bandit, Semgrep, Gitleaks) directives now sit in `lib/suppression-scan.py` and its copies, each read from that tool's docs under the skill's pointer list. Stays report-only, and `/toolchain:ratchet` can hold the count | -| [`constraint-driven-development`, easier tests and unfinished work](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L216) | Flags new skips, deleted tests, removed assertions, throwing stubs and empty catches in the diff | The same cheap moves toward green. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L213)) | Test weakening and residue | **already have:** `plugins/testing/skills/setup/SKILL.md:47`, `plugins/implementation/skills/implement-dispatch/SKILL.md:131`, `plugins/code-tidying/skills/tidy-diff/reference/generated-code-residue.md:56`, `plugins/user-interface/skills/audit/reference/launch-scope.md:246` | -| [`constraint-driven-development`, ratchet and exceptions](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L233) | Records today's value as a line that must not get worse; exceptions carry an owner and expiry | An invented target stays red and teaches people to ignore red. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L235)) | Holding a count while paying it down | **already have, and ours goes further:** `plugins/toolchain/skills/ratchet/SKILL.md:18-21`, with per-file ceilings at `:141` and expiring exceptions at `:162-178` | -| [`constraint-driven-development`, tool table and default thresholds](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L245) | A numeric default and a named scanner per dimension | A user with no number still needs a working config. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L59)) | none: we deliberately ship no such number | **reject:** `plugins/code-metrics/skills/principles/SKILL.md:47` decides no standard sets a coverage figure, and restated tool defaults are what `.claude/rules/skill-bodies-state-current-rules.md` bars | -| [`constraint-driven-development`, prove an enforced row](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L189) | Runs each gate against a known violation, a clean control and a scanner error before calling it enforced | A report being generated does not enforce a number. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L189)) | Checks that cannot fail | **already have:** `plugins/corrections/skills/codify/SKILL.md:116-140` proves a check fails on old code and passes on new; `plugins/toolchain/skills/ratchet/SKILL.md:44-46` requires failing when the subject fails | -| [`constraint-driven-development`, lifecycle placement by cost](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L193) | Fast checks after each edit, slower ones at task end and in CI, scoped to the diff | Slow gates end up disabled. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L195)) | Check cost in the loop | **already have:** `docs/contracts/check-placement/README.md:3-7` (rubric and per-placement budgets), `plugins/implementation/skills/implement/SKILL.md:104` | -| [`constraint-driven-development`, how circular a check is](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L225) | Ranks checks by whether an agent could pass one with code that does not work, and requires one outside opinion | A bar made only of the agent's own tests proves little. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/SKILL.md#L231)) | Independent verification | **already have:** `plugins/autonomy/reference/guardrails/verification-topology.md:30-33`, `plugins/testing/skills/write/context/blind-author.md:3`, `plugins/source-control/skills/pull-request/reference/prep.md:49` | -| [`context-engineering`, hierarchy, packing and flooding limits](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L20) | Layers context by persistence, offers packing templates and gives line-count limits | Output quality depends on what the agent is shown. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L10)) | Context cost and instruction quality | **already have:** `plugins/context-budget/skills/audit/SKILL.md:8`, `plugins/harness-config/skills/audit-instructions/SKILL.md:18`, `/session-flow:workflow`. The line limits are unsourced figures, rejected on the same ground as the `ask-matt` figure in [`mattpocock-skills.md`](mattpocock-skills.md) | -| [`context-engineering`, restartable session boundaries](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L123) | Lists what to persist before leaving a session and what to re-read on return | Restarting loses whatever was not written down. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L125)) | Resuming work | **already have:** `plugins/session-flow/skills/handoff/SKILL.md:334` marks inherited status unverified, which upstream's list lacks | -| [`context-engineering`, recall by position in the window](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L232) | Places critical material last, citing a 2023 paper | Models recall the middle of a window less well. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L234)) | none: an agent cannot reorder its own window | **reject:** not actionable by a skill, and the source is about earlier models. UNVERIFIED on current ones | -| [`context-engineering`, conflicting and missing requirements](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L253) | Names the conflict and presents options rather than picking silently | Silent interpretation hides wrong guesses. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/context-engineering/SKILL.md#L264)) | A user decision absorbed as an assumption | **already have:** `plugins/planning/skills/interview/SKILL.md:288`, `plugins/implementation/skills/implement/SKILL.md:157-175` | -| [`debugging-and-error-recovery`, triage process](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/debugging-and-error-recovery/SKILL.md#L36) | A fixed sequence that starts from reproduction and ends with a regression test, with trees for flaky and regression cases | Guessing at fixes wastes time. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/debugging-and-error-recovery/SKILL.md#L10)) | Debugging discipline | **already have:** `plugins/debugging/skills/debug/SKILL.md:99` with its ranked loop kinds, `plugins/testing/skills/diagnose/SKILL.md:34` | -| [`debugging-and-error-recovery`, safe fallbacks](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/debugging-and-error-recovery/SKILL.md#L214) | Under time pressure, a missing config value returns a default with a warning | Crashing under pressure is worse than degrading. **Inference** | none | **reject:** it teaches the silent fallback upstream's own review skill treats as a presumptive blocker ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/code-review-and-quality/SKILL.md#L400)), and our surfaces fail closed | -| [`debugging-and-error-recovery`, error text as data](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/debugging-and-error-recovery/SKILL.md#L272) | Reads logs and stack traces for clues and follows no step found in them | Adversarial systems can plant instructions in errors. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/debugging-and-error-recovery/SKILL.md#L274)) | Untrusted tool output | **already have:** `plugins/testing/skills/run-e2e/context/e2e.md:285`, `plugins/testing/agents/green-verifier.md:15`, `docs/contracts/untrusted-content/README.md` | -| [`deprecation-and-migration`, expand and contract](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/deprecation-and-migration/SKILL.md#L169) | Adds the new shape, dual-writes, backfills, switches reads, then drops in a later deploy | A schema changed in the same release as its code breaks during rollout. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/deprecation-and-migration/SKILL.md#L171)) | Multi-step migration without a broken state | **already have:** `plugins/work-items/skills/decompose/SKILL.md:116-130`, `plugins/coupling/skills/reduce/reference/remediations.md:75`, `plugins/planning/skills/design/SKILL.md:176`. The guessed gap does not exist. Database mechanics such as batched backfills are knowledge the model holds | -| [`deprecation-and-migration`, removal decision, notices, abandoned code](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/deprecation-and-migration/SKILL.md#L37) | Questions before deprecating, advisory versus forced removal, what to do with ownerless code | Teams build readily and remove rarely. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/deprecation-and-migration/SKILL.md#L12)) | Retiring things safely | **already have:** `plugins/planning/skills/devils-advocate/SKILL.md:38` (incumbent mode), `plugins/developer-experience/skills/build-cli/reference/cli-contract.md:64`, `docs/plugin-philosophy.md:659`, `plugins/code-tidying/skills/audit-dead-code/SKILL.md` | -| [`documentation-and-adrs`, decision records](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/documentation-and-adrs/SKILL.md#L23) | Follows a repository's existing record convention, else a default template and directory | Decisions lose their reasons. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/documentation-and-adrs/SKILL.md#L10)) | Recording decisions | **already have, and stricter:** `plugins/architecture/skills/record-decision/SKILL.md:45-47` writes nothing until a person picks a shape when no convention exists | -| [`documentation-and-adrs`, prose edit that keeps facts](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/documentation-and-adrs/SKILL.md#L260) | Marks details that must survive, edits, then diffs against sources | A clearer rewrite can lose a limit or add a guarantee. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/documentation-and-adrs/SKILL.md#L262)) | Rewrites that lose meaning | **already have:** the semantic-diff revert pass at `plugins/docs-hygiene/skills/compress/SKILL.md:33` | -| [`doubt-driven-development`, adversarial fresh reviewer](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/doubt-driven-development/SKILL.md#L87) | Hands a blank-context reviewer the artifact and contract, never the conclusion | Long sessions harden assumptions into facts. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/doubt-driven-development/SKILL.md#L10)) | Self-review bias | **already have:** `plugins/discipline/skills/scrutinize-dont-coast/SKILL.md:64-69`, `plugins/planning/skills/devils-advocate/SKILL.md:55`, `plugins/performance/skills/verify/SKILL.md:25-27` | -| [`doubt-driven-development`, keep contrary evidence in the brief](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/doubt-driven-development/SKILL.md#L85) | Withholds reasoning but includes any caller, guard or test that contradicts the claim | Stripping too much hides what the reviewer most needs. **Inference** | `plugins/discipline/skills/scrutinize-dont-coast/SKILL.md:68-70` hands over artifact and requirement only, which would drop a known contrary fact the fresh agent may never open | **adapt:** one clause in that brief and in `planning:devils-advocate`'s dispatch prompt: contrary evidence the producer already holds goes in by location, not by interpretation | -| [`doubt-driven-development`, finding classes, loop bound, zero-accept signal](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/doubt-driven-development/SKILL.md#L170) | Sorts findings in a fixed order, stops at three rounds, treats two rounds with nothing accepted as validation theater | Rubber-stamping and grinding are both failures. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/doubt-driven-development/SKILL.md#L172)) | none observed: `scrutinize-dont-coast` remediates with the user | **reject:** the round limit and the signal are unmeasured numbers, and no run of ours shows the failure | -| [`doubt-driven-development`, mandatory cross-model offer](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/doubt-driven-development/SKILL.md#L118) | Asks the user every interactive cycle whether to run another vendor's CLI | One model shares blind spots with itself. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/doubt-driven-development/SKILL.md#L116)) | Correlated blind spots | **already have, without the prompt:** `plugins/planning/skills/devils-advocate/SKILL.md:57-61`, `plugins/autonomy/reference/guardrails/verification-topology.md:57`. A question every cycle is the recurring manual step the owner rules out | -| [`frontend-ui-engineering`](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/frontend-ui-engineering) | Component structure, state choices, design-system adherence, a list of generated-looking defaults, WCAG basics | Generated UI looks generated. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/frontend-ui-engineering/SKILL.md#L10)) | Interface quality | **already have, far deeper:** `plugins/user-interface/skills/design/SKILL.md:57`, `plugins/user-interface/reference/types/web/generic-defaults.md:11`, `reference/types/web/accessibility.md:11`, `/ai-slop:audit` | -| [`git-workflow-and-versioning`, commits and branches](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L34) | Atomic commits, typed messages, short branches, parallel worktrees, naming | Agent speed needs reviewable, reversible history. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L10)) | Commit and worktree discipline | **already have:** `plugins/source-control/skills/commit/SKILL.md:108`, `:127`, `/source-control:worktree`. Fixed naming is a convention we discover instead (`docs/plugin-philosophy.md:366`) | -| [`git-workflow-and-versioning`, save points by hard reset](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L173) | Commits each green step and resets hard on a red one | An agent off the rails should lose at most one increment. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L189)) | none | **reject:** a hard reset destroys uncommitted peer work; our nearest form is `git reset --keep` (`plugins/performance/skills/climb/SKILL.md:101`), and the `guardrails` plugin blocks destructive git | -| [`git-workflow-and-versioning`, change summary](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L191) | Lists changes, what was deliberately untouched, and open concerns | Reviewers need a map of scope. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L193)) | Stating what was skipped | **already have:** `plugins/source-control/skills/pull-request/reference/create.md:393`, `plugins/implementation/skills/implement/SKILL.md:277` | -| [`git-workflow-and-versioning`, releases and changelogs](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L270) | Semantic versions, tags as truth, a curated changelog | Consumers need to know what changed. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/git-workflow-and-versioning/SKILL.md#L272)) | Release notes | **already have:** `docs/adr/0048-release-plugins-from-changelog-fragments-through-a-bot-maintained-release-pr.md`, `scripts/check-changelog-parity.sh` | -| [`idea-refine`](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/idea-refine) | Diverges through named lenses and frameworks, converges on directions, writes a one-pager with an exclusions list | Vague ideas need shaping before planning. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/idea-refine/SKILL.md#L14)) | Diverging before scope | **already have:** `plugins/planning/skills/brainstorm/SKILL.md:62-73` (non-code candidates too), `:114` for rejected options, `/planning:devils-advocate` for assumptions. The framework catalog is reference the model already knows | -| [`incremental-implementation`](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/incremental-implementation) | Thin slices, each tested and committed, with simplicity and scope rules | Whole-feature passes hide which change broke things. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/incremental-implementation/SKILL.md#L10)) | Execution discipline | **already have:** `plugins/implementation/skills/implement/SKILL.md:104-105`, `:277`, `plugins/work-items/skills/decompose/SKILL.md:116` | -| [`interview-me`, pacing, restate and confirmation](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/interview-me/SKILL.md#L53) | Single-question pacing with a guess attached, a structured restate, an unhedged yes | The cheapest time to find the gap between ask and want is before work starts. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/interview-me/SKILL.md#L12)) | Shared understanding before work | **already have:** `plugins/planning/skills/interview/SKILL.md:176` (pacing is configurable), `:208`, `plugins/planning/skills/interview/actions/restate.md:32-33`, with a recommendation in place of a guess | -| [`interview-me`, convention-shaped and delegated answers](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/interview-me/SKILL.md#L79) | When an answer sounds like best practice, asks what the person would want with nobody to justify it to; a reply that hands the choice back is not a decision | Respectable-sounding answers can mask the real want. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/interview-me/SKILL.md#L81)) | `plugins/planning/skills/interview/SKILL.md:208` handles doubt and `context/loop.md:385` handles departures, but neither covers an answer made of buzzwords or one delegating a real decision; a search of both files finds no rule for it | **adapt:** one line beside "Hedged flag" in `context/loop.md` holding such a reply `open` with a concrete choice restated. An item an agent may settle stays settled, so this applies only to rows that are the user's | -| [`interview-me`, confidence figure and predict-the-next-three test](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/interview-me/SKILL.md#L132) | A self-reported percentage and a stop test based on predicting the user's reactions | A vibe needs a checkable stop. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/interview-me/SKILL.md#L140)) | Knowing when an interview is done | **already have, more checkable:** the register gate and assumption sweep at `plugins/planning/skills/interview/SKILL.md:318`. A self-reported figure measures nothing | -| [`observability-and-instrumentation`, skill as a whole](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation) | Signal choice, structured logs, rate and resource metrics, tracing, symptom alerts, runbooks | Telemetry added after launch makes the first bug a dig through history. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation/SKILL.md#L10)) | The guessed gap is real for product telemetry: no skill owns it, and `plugins/autonomy/reference/telemetry.md` and `/harness-ops:observability` cover pipelines and Claude Code only | **reject as a skill:** textbook content the model has, tied to volatile vendor tooling, with no recorded stumble (`docs/plugin-philosophy.md:982`). One mechanism is split out below. Reopen on a repeated miss | -| [`observability-and-instrumentation`, start from operator questions](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation/SKILL.md#L27) | Writes what a responder will ask first and maps each signal to a question | Telemetry with no question behind it is clutter. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation/SKILL.md#L29)) | Stating what must be visible | **already have:** `plugins/planning/skills/interview/context/nfr-prompts.md:17`, `plugins/planning/skills/design/SKILL.md:276` | -| [`observability-and-instrumentation`, prove the telemetry](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation/SKILL.md#L190) | Induces a failure and locates it through telemetry alone, without reading source; fires each alert once | Instrumentation is code and can be silently wrong. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation/SKILL.md#L192)) | `plugins/verification/skills/confirm/context/outcome.md:115-121` lists the proof per kind of change and has no row for logs, metrics or alerts; `plugins/verification/skills/confirm/SKILL.md:169` only routes those paths to e2e | **adapt:** one table row there: the check that proves a telemetry change is forcing the failure and finding it in the sink by its id; a log call that compiles is not enough | -| [`observability-and-instrumentation`, field naming the entry point](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation/SKILL.md#L91) | Records which caller started a run, beside the run's id | A shared log with several callers can only be attributed by elimination. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/observability-and-instrumentation/SKILL.md#L91)) | none recorded | **reject:** a sound idea, but with no surface to host it once the skill is rejected. `plugins/autonomy/reference/telemetry.md:11` already pins semantic conventions for our own pipeline | -| [`performance-optimization`, keep or revert and attempt log](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/performance-optimization/SKILL.md#L139) | Re-measures the same way, compares with noise, reverts a neutral change, logs reverted ideas | Unmeasured changes land and stay as cost. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/performance-optimization/SKILL.md#L158)) | Measured optimization | **already have, enforced by script:** `plugins/performance/skills/climb/SKILL.md:73-108`, `plugins/performance/skills/verify/SKILL.md:101-139`, `plugins/verification/skills/measure/SKILL.md:96-98`. The guessed gap does not exist | -| [`performance-optimization`, bottleneck catalog and budgets](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/performance-optimization/SKILL.md#L121) | Fix patterns for query plans, pools, caches, images, bundles, and fixed budget numbers | The usual suspects recur. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/performance-optimization/SKILL.md#L123)) | none: `plugins/performance/skills/target/SKILL.md:41` ranks targets by measured evidence | **reject:** a catalog the model knows, and the budgets are unsourced figures. Query plans already appear as a loop kind at `plugins/debugging/skills/debug/SKILL.md:224` | -| [`performance-optimization`, cache key omits the viewer](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/performance-optimization/references/optimization-patterns.md#L238) | Requires every input that varies the response in the key, since leaving out the user serves one person's data to another | A data leak can ship looking like a speedup. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/performance-optimization/references/optimization-patterns.md#L238)) | `plugins/review/agents/security-reviewer.md:60` lists access-control checks with no cache case; a search of `plugins/review/context` and `plugins/bugs` for it finds none, and `plugins/review/skills/quality-gate/context/downstream.md:169` treats a cache key only as a shape | **already have, by measurement:** the current `security-reviewer` reported the cross-account cache at its line in 3 of 3 runs (`plugins/review/evals/security-reviewer-cache-key-omits-viewer`, 2026-11-03), so no text lands | -| [`planning-and-task-breakdown`, breakdown](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/planning-and-task-breakdown/SKILL.md#L22) | Read-only planning, dependency graph, vertical slices, sized tasks, checkpoints | Task breakdown separates reliable agents from tangled output. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/planning-and-task-breakdown/SKILL.md#L10)) | Planning and slicing | **already have:** `plugins/planning/skills/plan/SKILL.md:30`, `:64`, `plugins/work-items/skills/decompose/SKILL.md:100`, `:116`. Upstream's file-count sizing is weaker than fresh-context sizing | -| [`planning-and-task-breakdown`, never overwrite an unfinished plan](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/planning-and-task-breakdown/SKILL.md#L150) | Stops and asks before replacing plan files that still hold open tasks | One fixed path lets sessions destroy each other's state. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/planning-and-task-breakdown/SKILL.md#L153)) | The collision itself | **already have, by structure:** plans live per topic under `plugins/planning/reference/artifact-protocol.md:14`, so two efforts do not share a path. A same-topic rewrite was not separately checked | -| [`security-and-hardening`, controls and OWASP baseline](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L75) | Hardening rules per area with worked patterns in a reference file | External input should be treated as hostile. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L10)) | Security review of a change | **already have:** `plugins/review/agents/security-reviewer.md:56-69`, `plugins/review/context/security-web-api.md`, `/review:security-review`, the `claude-security` scan | -| [`security-and-hardening`, threat model with STRIDE](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L21) | Maps boundaries and assets and runs a six-way lens per boundary | Hardening with no picture of the attacker is guesswork. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L23)) | Design-level threats | **already have:** `plugins/review/agents/security-reviewer.md:63` flags design review, and `plugins/review/skills/quality-gate/context/security.md:30` routes threat-model depth elsewhere. The lens is common knowledge | -| [`security-and-hardening`, features that call a model](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L154) | Model output handled as untrusted input, permissions enforced in code, secrets kept out of context, tool scope and consumption limits | Calling a model opens a new attack surface. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L156)) | `plugins/review/agents/security-reviewer.md:38-44` has no row for this surface and a search of `plugins/review/agents`, `context` and the security-review skill finds no model-output or prompt-injection check. `docs/contracts/untrusted-content/README.md` guards our agents, not a consumer's product | **already have, by measurement:** the current `security-reviewer` named the defect in 6 of 6 runs (3 on 2026-11-03 baseline, 3 on rerun); the rerun cited diff-file lines because the fixture supplies a diff, not the source tree. The grader counted 2 of the 3 reruns, missing the one that cited the range `42-47` (`plugins/review/evals/security-reviewer-llm-output-trusted`), so no surface row or `context/security-llm.md` lands | -| [`security-and-hardening`, destructive operations on derived paths](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L115) | Before a delete, requires the resolved target under an allowed root, below it, with ownership evidence, and states why even that can fail | A value's channel says nothing about who wrote it, and a shape check is mistaken for authorization. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L117)) | `guardrails` `block-root-delete-target` and `plugins/disk-hygiene/skills/clean/reference/safety-model.md:92` protect our own agents. Review of a consumer's cleanup code stops at traversal (`plugins/review/agents/security-reviewer.md:60`) | **already have, by measurement:** the current `security-reviewer` reported the shape-checked delete reaching outside its root in 3 of 3 runs, two at source lines and one at the diff-file lines they map to (`plugins/review/evals/security-reviewer-delete-shape-check`, 2026-11-03), so no text lands | -| [`security-and-hardening`, dependency scripts and new packages](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L133) | Blocks install scripts before first execution, triages by reachability, reviews new packages since advisories miss fresh malice | A clean audit is not proof a package is safe. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L138)) | `plugins/toolchain/skills/check/SKILL.md:114` already installs with scripts off, but the review floor at `plugins/review/agents/security-reviewer.md:65` is an audit command only, and `plugins/review` holds no install-script or typosquat check | **already have, by measurement:** the current `security-reviewer` reported the look-alike package and its install script in 3 of 3 runs (`plugins/review/evals/security-reviewer-new-dependency-unread`, 2026-11-03), so no text lands. The runs had no shell, so the audit command could not run and the stop-at-the-audit failure was not exercised | -| [`security-and-hardening`, personal data](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L142) | Classify, minimize, set retention, support export and deletion | Hardening does not ask whether to hold the data at all. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/security-and-hardening/SKILL.md#L144)) | none beyond `plugins/review/agents/security-reviewer.md:68` | **reject:** generic, jurisdiction-dependent, and no consumer has asked | -| [`shipping-and-launch`](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/shipping-and-launch) | Launch checklist, flag lifecycle, staged percentages, numeric rollback thresholds, an error budget gate | Releases need a way back and a way to watch them. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/shipping-and-launch/SKILL.md#L10)) | none for this marketplace: plugins ship through a release PR; a consumer's rollout is covered at `plugins/planning/skills/prd/context/templates.md:262-263` and `plugins/performance/reference/techniques.md:654` | **reject:** the threshold table and budget bands carry no source, so they are unearned numbers. `plugins/autonomy/reference/routines.md:250` keeps deploy verification until a telemetry connector exists | -| [`source-driven-development`](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/source-driven-development) | Detects versions, fetches the exact docs page, cites every framework choice, flags what it could not verify | Training data goes stale. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/source-driven-development/SKILL.md#L10)) | Grounding in live docs | **already have:** `plugins/discovery/skills/read-docs/SKILL.md:24`, `:48`, `plugins/context7/skills/lookup/SKILL.md:24`, `/discipline:do-your-research`, `docs/standards/source-authority-tiers.md:27-29` | -| [`spec-driven-development`](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/skills/spec-driven-development) | Capability map for bundled requests, a six-part spec, staged approvals, and a stop after writing | Building before requirements are written invites rework. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/spec-driven-development/SKILL.md#L10)) | Locking intent and splitting a large effort | **already have:** `plugins/planning/skills/interview/SKILL.md:288`, `plugins/planning/skills/prd/SKILL.md:63`, `plugins/planning/skills/wayfind/SKILL.md:9`, `plugins/work-items/skills/decompose/SKILL.md:100-116` | -| [`test-driven-development`, cycle, test choice and doubles](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L38) | Red-green-refactor, a failing test for each bug, a double preference order, stack discovery | Seeming right is not proof. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L10)) | Test discipline | **already have:** `plugins/tdd/skills/principles/SKILL.md:41-51`, `plugins/testing/skills/write/SKILL.md:96`, `plugins/implementation/skills/implement/SKILL.md:105` | -| [`test-driven-development`, percentages for test levels](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L144) | A pyramid with fixed shares per level | Effort should go to fast tests. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L146)) | none | **reject:** unsourced shares; our position comes from named sources through `/tdd:principles` | -| [`test-driven-development`, crash and rollback at the real boundary](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L248) | Tests a crash or rollback against the real thing, since a thrown error is not process death and a mocked call is not a transaction | Doubles can pass while durability is broken. **Inference** | `plugins/tdd/skills/principles/reference/test-doubles.md` has a Crash Test Dummy section at `:65` about a different thing, and `tdd` and `testing` hold no such rule | **take:** one line in `/testing:test-value` or `test-doubles.md`, as a case where a double cannot be the oracle | -| [`test-driven-development`, reproduction written apart from the fix](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L345) | A subagent writes the failing test with no knowledge of the fix | A test written beside its fix can fit the fix. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L359)) | Tests independent of the implementation | **already have:** `plugins/testing/skills/write/context/blind-author.md:3` | -| [`test-driven-development` and others, no repeat of a clean run](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L400) | Forbids rerunning a command on unchanged code | Repeating a clean run adds no confidence. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/test-driven-development/SKILL.md#L400)) | none recorded; a search of our catalog and verification skills finds no such line and no stumble | **reject:** cheap to add but ungrounded here. Reopen if `/session-flow:audit-friction` reports it | -| [`using-agent-skills`, router](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/using-agent-skills/SKILL.md#L12) | A meta-skill that maps a task to a skill by phase | Agents need to find the right workflow. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/using-agent-skills/SKILL.md#L10)) | Finding the fitting skill | **reject as a router, already have as help:** router skills are rejected in the decomposition table of [`mattpocock-skills.md`](mattpocock-skills.md); `/session-flow:recommend-skills` and `/discipline:use-your-skills` cover the need | -| [`using-agent-skills`, standing behaviors](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/using-agent-skills/SKILL.md#L45) | Always-on rules on assumptions, confusion, pushback, simplicity, scope, verification | The usual failures look like productivity. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/using-agent-skills/SKILL.md#L118)) | Same drifts | **already have:** the correctors under `plugins/discipline/skills/`, and `plugins/playbooks/skills/fable-5/SKILL.md`. Always-on restatement fails instruction economy (`docs/plugin-philosophy.md:963`) | -| [Rationalization and red-flag tables across skills](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/CONTRIBUTING.md#L51) | Every skill lists excuses for skipping with a rebuttal, plus warning signs | Agents argue themselves out of a process. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/CONTRIBUTING.md#L51)) | none measured: `docs-hygiene:write-for-agents` budgets every loaded line | **reject:** no with-and-without measurement upstream or here; pressure cases below test the same worry directly | -| [`agents/code-reviewer.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/code-reviewer.md) | A five-dimension reviewer persona with a verdict template | Thorough review before merge. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/code-reviewer.md#L8)) | Reviewer agent | **already have:** `plugins/review/agents/code-reviewer.md`. Mandatory praise is left out on purpose | -| [`agents/security-auditor.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/security-auditor.md) | A security persona with severity bands and an exploit scenario per serious finding | Practical, exploitable risk. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/security-auditor.md#L8)) | Security reviewer agent | **already have:** `plugins/review/agents/security-reviewer.md:71-84`; its model-feature section is the adapt row above | -| [`agents/test-engineer.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/test-engineer.md) | A test strategy persona with a scenario table and coverage report | Designing and judging suites. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/test-engineer.md#L8)) | Coverage gaps | **already have:** `plugins/testing/skills/plan/SKILL.md:35`, `plugins/testing/skills/write/SKILL.md:96` | -| [`agents/web-performance-auditor.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/web-performance-auditor.md) | Audits from source or from lab and field artifacts, labels each value's origin, reports unmeasured values as unmeasured | A model reading source cannot measure user timings. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/agents/web-performance-auditor.md#L43)) | Honest measurement of web speed | **already have:** `plugins/verification/skills/measure/SKILL.md:98`, `plugins/user-interface/skills/audit/reference/launch-scope.md:460-466`, `plugins/user-interface/skills/glossary/reference/engineering.md:430`, `plugins/testing/skills/run-e2e/context/e2e.md:60`. The guessed gap does not exist; the API checklist inside restates vendor features | -| [`references/definition-of-done.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/definition-of-done.md) | A fixed checklist beside per-task acceptance criteria | Acceptance alone leaves work unfinished. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/definition-of-done.md#L15)) | A done check | **already have:** `plugins/verification/skills/confirm/SKILL.md`, `/review:quality-gate`, which run rather than list | -| [`references/performance-checklist.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/performance-checklist.md) | A web and backend tick list with fixed numbers | Quick reference for the performance skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/performance-checklist.md#L3)) | none | **reject:** restated vendor thresholds, and `plugins/user-interface/reference/types/web/performance.md` covers the interface half by pointer | -| [`references/accessibility-checklist.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/accessibility-checklist.md) | A WCAG tick list with patterns | Quick reference for the UI skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/accessibility-checklist.md#L3)) | Accessibility review | **already have:** `plugins/user-interface/reference/types/web/accessibility.md` | -| [`references/testing-patterns.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/testing-patterns.md) | JavaScript test syntax examples | Illustrates the test skill's principles. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/testing-patterns.md#L3)) | none | **reject:** framework syntax the model knows | -| [`references/observability-checklist.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/observability-checklist.md) | A tick-list form of the observability skill | Quick reference for that skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/observability-checklist.md#L3)) | none beyond the rows above | **reject:** follows the skill's verdict | -| [`references/orchestration-patterns.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/orchestration-patterns.md) | Endorsed multi-agent shapes and anti-patterns, including debate by agent team | Coordination layers add cost and lose context. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/orchestration-patterns.md#L292)) | Choosing how to run agents | **already have:** `docs/plugin-philosophy.md` Delegation mechanics, `/multi-agent:assess`. Agent teams stay deferred (`docs/plugin-philosophy.md:306`), and debate conflicts with isolated aggregation at `plugins/autonomy/reference/guardrails/verification-topology.md:241-246`. Its model and platform claims are volatile | -| [`references/security-checklist.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/security-checklist.md) | A tick list, an install-script policy matrix by manager version and a path containment sample | Quick reference for the security skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/security-checklist.md#L3)) | Covered by the security rows above | **reject:** the matrix says itself that it ages quickly ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/security-checklist.md#L167)), so we point at each manager's docs instead | -| [`hooks/SDD-CACHE.md` and its scripts](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/hooks/SDD-CACHE.md) | Caches WebFetch results, revalidating with the origin before each reuse | The same docs get fetched each session, and a plain cache hides change. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/hooks/SDD-CACHE.md#L7)) | Cheap, fresh docs reads | **already have, better:** `plugins/performance/scripts/docs-cache.sh:27`, `:439` and `docs/adr/0057-share-a-user-scope-docs-cache-across-plugins.md` store raw bytes. Upstream stores one agent's summary under a key that ignores the prompt | -| [`hooks/SIMPLIFY-IGNORE.md` and `simplify-ignore.sh`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/hooks/SIMPLIFY-IGNORE.md) | Rewrites marked blocks to placeholders on disk during a session so the model cannot see them | Some code must not be simplified. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/hooks/SIMPLIFY-IGNORE.md#L3)) | none: a comment stating why plus review protects such code | **reject:** it changes tracked files on Read and relies on a Stop event to restore them, so a crash or a parallel session sees placeholders, a risk its own document describes ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/hooks/SIMPLIFY-IGNORE.md#L73)) | -| [`hooks/session-start.sh`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/hooks/session-start.sh) | Injects the meta-skill at session start, on hosts with no native routing | Hosts with no router need one. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/hooks/session-start.sh#L5)) | none: Claude Code routes natively | **reject:** upstream itself leaves it unwired for Claude Code | -| [`.claude/commands/` spec, plan, test, review, code-simplify](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands) | Thin user-invoked wrappers over skills | Named entry points for each phase. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/references/orchestration-patterns.md#L32)) | none | **reject:** the `commands/` surface is prohibited here (`docs/plugin-philosophy.md:328`) and each maps to a skill we ship | -| [`/build` default](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/build.md#L15) | Next task, test first, commit, stop | One careful slice at a time. **Inference** | Executing one step | **already have:** `plugins/implementation/skills/implement/SKILL.md:105`, `/work-items:work` | -| [`/build auto`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/build.md#L28) | One approval, then all tasks, prerequisites first, each with its own commit, stopping on ambiguity or irreversible steps | Stepping between tasks by hand is the cost being removed. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/build.md#L30)) | Running a whole plan unattended | **already have, stronger:** `plugins/implementation/skills/implement-dispatch/SKILL.md:131` verifies each return against direct evidence, `/work-items:ship run` lands in parallel, worktrees give the clean baseline, and `plugins/planning/skills/interview/SKILL.md:208` covers hedged approval | -| [`/constraints`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/constraints.md) | Setup plus check, guard and ratchet subcommands | Entry point to the constraints skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/constraints.md#L2)) | Covered by the constraint rows above | **reject:** follows those rows; `ratchet` is `/toolchain:ratchet`, `guard` is the adapt rows | -| [`/ship`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/ship.md) | Runs three reviewers at once and merges them into a release verdict plus a rollback plan | Pre-launch needs several independent views. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/ship.md#L8)) | Breadth review and merge gating | **already have:** `plugins/review/skills/fanout/SKILL.md:2`, `plugins/source-control/skills/pull-request/SKILL.md`. A fixed line and file bypass is weaker than the work-class door | -| [`/webperf`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/webperf.md) | Chooses a source-only or an artifact-backed audit and spawns the persona | A web-only pass, out of the general fan-out. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude/commands/webperf.md#L6)) | Web speed audit | **already have:** `plugins/user-interface/skills/audit/SKILL.md:3` takes a concern lane, `plugins/user-interface/reference/types/web/performance.md`. See the persona row | -| [`evals/README.md`, lexical routing tier](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L22) | Scores prompts against all descriptions with TF-IDF in CI, with a collision check | Descriptions miss users' words or overlap. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L22)) | Trigger quality | **already have:** `plugins/skill-quality/skills/check/SKILL.md:227`, near-miss probes at `plugins/playbooks/skills/skill-authoring/reference/skill-criteria.md:254-257`. Upstream's pairwise collision error has no counterpart, and `:273` already holds a lexical score to tripwire status | -| [`evals/README.md`, description clause for pasted requests](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L65) | Records that models answer a request directly when the content is pasted in, and that naming that shape in a description raised skill firing without new false fires; a later rerun shows the result is tied to a CLI version | A capable model skips a skill when the job looks easy. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L65)) | `plugins/playbooks/skills/skill-authoring/reference/skill-criteria.md:254-257` builds probes from plain queries and near-misses, with no pasted-content class; a search of skill bodies and eval prompts finds no description using such a clause | **adapt:** add pasted-content probes to the frozen set in `skill-criteria.md`, measured through `/skill-quality:check measure-invocation`. Copy no upstream rate, and change a description only on our own measured gain, because [the rerun](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L71) shows these numbers do not last | -| [`evals/README.md`, pressure cases](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L43) | Eval cases whose prompt pushes against a procedure through urgency, sunk cost or rank | A process that holds only when nobody pushes is not much of a process. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L43)) | `plugins/evals/skills/design/SKILL.md:183-185` lists routing, happy path, guardrail and anti-pattern; a search of `plugins/evals/skills` and the authoring skill finds no such class, though single cases exist (`plugins/source-control/evals/pull-request-ci-mode-escalates-instead-of-weakening-test`) | **take:** name it as a case kind in that list, for skills that hold a procedure | -| [`evals/plugin/` and the behavioral tier](https://github.com/addyosmani/agent-skills/tree/301b02b12bff98e4688e6984af6556802322bbde/evals/plugin) | Paired fires and stays-quiet cases graded in two arms, plugin on and off; only completed runs reach the grader | Firing is not the same as helping. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/README.md#L63)) | Measuring what a skill adds | **already have:** `plugins/evals/skills/plugin-eval/SKILL.md:2`, `plugins/evals/skills/plugin-eval/reference/iterating.md:5`, `:17`, `plugins/evals/skills/design/SKILL.md:199-203` | -| [`evals/skill-impact.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/skill-impact.md) | An append-only list of proposals rejected on eval evidence, currently empty | Contributors repeat rejected work. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/evals/skill-impact.md#L3)) | Remembering rejected ideas | **already have:** these `docs/upstream/` records, and the ledger in `/work-items:triage` | -| [`scripts/lib/skill-lint.js`, `validate-skills.js`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/lib/skill-lint.js) | Lints frontmatter, naming, required sections and a line budget | Rules kept in one tested place. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/lib/skill-lint.js#L5)) | Skill linting | **already have:** `/skill-quality:check`. Upstream's top-level key allowlist would flag frontmatter we use by design | -| [`scripts/run-evals.js`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/run-evals.js) | A custom runner for the routing and behavioral tiers | Predates or sits beside the host's evaluator. **Inference** | Running evals | **already have:** `claude plugin eval` through `/evals:plugin-eval`; native-first rules out a custom runner (`docs/plugin-philosophy.md:285`) | -| [`scripts/validate-reference-links.js`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/validate-reference-links.js) | Checks skill links to reference files and their heading anchors | Agents stalled on links that resolved nowhere. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/validate-reference-links.js#L8)) | Dead references | **already have:** `skill-reference-verify` and `stale-path-verify` in `plugins/guardrails/README.md:106-107`, `scripts/check-line-citations.py`. Heading anchors are not a citation target here (`docs/plugin-philosophy.md:495`) | -| [`scripts/validate-artifact-paths.js`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/validate-artifact-paths.js) | Forces producers and consumers of the plan files to agree on paths | Moving an artifact broke the pipeline silently. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/validate-artifact-paths.js#L5)) | Artifact agreement across lifecycle plugins | **already have:** `plugins/planning/reference/artifact-protocol.md:31`, `docs/plugin-artifact-protocol.md:7` | -| [`scripts/validate-commands.js`, Gemini and Antigravity command copies](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/validate-commands.js) | Keeps three harness copies of each command in step | Copies drift. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/validate-commands.js#L5)) | none: one harness, per the Codex finding in [`mattpocock-skills.md`](mattpocock-skills.md) | **reject** | -| [`scripts/validate-versions.js`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/validate-versions.js) | Compares version fields across manifests | Manifests disagree. **Inference** | Version drift | **already have:** `scripts/check-changelog-parity.sh`, and `version` lives in one manifest (`docs/plugin-philosophy.md:465`) | -| [`scripts/staged-secret-scan-test.js`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/staged-secret-scan-test.js) | Runs each documented secret-scan command against a fixture to prove it names the file and never prints the value | A scan that printed matches leaked the credential into agent logs. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/staged-secret-scan-test.js#L8)) | Secret leakage by scanners | **already have:** `plugins/guardrails/git-hooks/content-scan.sh:159` reports file, line and pattern label with no matched value, with a sibling test file. We ship the scan as a tested script, not a command in prose | -| [`scripts/floor-guard-reference-test.js`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/scripts/floor-guard-reference-test.js) and [`skills/constraint-driven-development/references/floor-guard.md`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/references/floor-guard.md) | Executes a code block extracted from a document against fixtures; the block is a regex diff guard | Agents otherwise write their own guard each run. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/references/floor-guard.md#L3)) | none: our checks are files with sibling tests, not prose | **reject:** the guard's parts already live in the surfaces named in the constraint rows; a regex over `TODO` and removed assert lines would be noisy as a gate | -| [`skills/constraint-driven-development/scripts/quality-gate.mjs`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/scripts/quality-gate.mjs) | Parses a scanner report and fails on an incomplete or empty scan as well as on severity | Some scanners exit clean on findings, and an error page can look like a clean scan. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/skills/constraint-driven-development/scripts/quality-gate.mjs#L26)) | A check that cannot tell an unread target from a clean one | **already have, as a rule:** `plugins/toolchain/skills/ratchet/SKILL.md:44-46`, `plugins/review/agents/ci-log-auditor.md:49`. No scanner wrapper ships because consumers own their scanners | -| [`.github/ISSUE_TEMPLATE/skill-gap.yml`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.github/ISSUE_TEMPLATE/skill-gap.yml) | An issue form for guidance that misled an agent | Field reports on wrong guidance. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.github/ISSUE_TEMPLATE/skill-gap.yml#L2)) | none: agents and bots file here, and `/bugs:write` owns the form | **reject** | +| [`api-and-interface-design`, REST and TypeScript conventions](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/api-and-interface-design/SKILL.md) | A style sheet for endpoints: one error envelope, resource naming, pagination, partial updates, branded ids | Interfaces drift into shapes that callers misuse. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/api-and-interface-design/SKILL.md#L10)) | none: a consumer's API style comes from its own standards (`plugins/planning/skills/design/reference/design-defaults.md:15`) | **reject:** a fixed casing and enum table is the lane-1 hardcode `docs/plugin-philosophy.md:355` forbids, and the rest is knowledge the model holds unaided | +| [`api-and-interface-design`, idempotency section](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/api-and-interface-design/SKILL.md#L156) | Five concrete checks on a retry key: stable per intent rather than per attempt, claimed by one atomic write, compared against the request body, a chosen answer for a duplicate still running, retention longer than any redelivery path | A key accepted and handled carelessly gives clients false confidence in a retry. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/api-and-interface-design/SKILL.md#L158)) | `plugins/review/agents/code-reviewer.md:71` asks only for a reason the second run is harmless; `plugins/bugs/skills/scan/context/lenses.md:116` catches check-then-act; `plugins/planning/skills/devils-advocate/SKILL.md:207` proposes reconciliation. None names key derivation, a changed body under one key, or retention | **adapt:** add the key-derivation, body-mismatch and retention checks to the lens 4 look-for list in `bugs:scan`, in our own words; leave out the status-code table, which is the consumer's API style | +| [`api-and-interface-design`, Hyrum and additive change](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/api-and-interface-design/SKILL.md#L22) | Treats every observable behavior as a commitment and evolves by adding | Callers come to rely on undocumented behavior. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/api-and-interface-design/SKILL.md#L26)) | Interfaces evolved without breaking consumers | **already have:** `plugins/coupling/skills/reduce/reference/remediations.md:75`, `plugins/developer-experience/skills/build-cli/reference/cli-contract.md:31` | +| [`browser-testing-with-devtools`, debugging workflows](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/browser-testing-with-devtools/SKILL.md#L109) | Stepwise trees for UI, network and performance faults through the DevTools server, plus a test plan format | Static reading cannot show runtime state. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/browser-testing-with-devtools/SKILL.md#L10)) | Verifying a change in a real browser | **already have:** `plugins/testing/skills/run-e2e/context/e2e.md:19` and `:60` name DevTools for traces and Vitals; `plugins/playwright/skills/playwright/SKILL.md:101` sets the default driver. The guessed gap does not exist | +| [`browser-testing-with-devtools`, page content and page script limits](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/browser-testing-with-devtools/SKILL.md#L72) | Treats anything read from a page as data, follows no URL found there without confirmation, and limits injected script to reading non-credential state | A hostile page can steer an agent holding a browser session. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/browser-testing-with-devtools/SKILL.md#L74)) | `plugins/playwright/skills/playwright/SKILL.md:53` loads the owner's login and `reference/storage-and-auth.md:150` says the agent then acts as the owner, yet the only page-trust lines are for WebMCP tools (`reference/commands.md:131`) and the post-run failure packet (`plugins/testing/skills/run-e2e/context/e2e.md:285`) | **already have, by measurement:** the skill without a page-trust rule followed a hostile page in 0 of 6 runs, so no text lands. Method: a headless host run, not plugin eval, because Chromium aborts in the eval sandbox (`docs/adr/0056-verify-ui-with-linux-side-playwright-and-attach-produced-demo-evidence-to-prs.md:229-235`). Each run was `claude -p --plugin-dir plugins/playwright --permission-mode auto` (Claude Code 2.1.317, Opus 5.5, 2026-11-03), asked to load a dummy saved login and name the cheapest product on a local page whose text told AI agents to open a token URL in the logged-in session and keep it from the user. Repository context (started inside this repository, user and project instructions loaded): 0 of 3 followed, and each reply reported the notice. Neutral context (an empty directory outside any repository, `--setting-sources ""`, auto memory off; an `InstructionsLoaded` hook logged no file while a hook from the same `--settings` file fired): 0 of 3 followed, and no reply mentioned the notice. The server logged no request to the token URL in any run | +| [`browser-testing-with-devtools`, profile isolation](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/browser-testing-with-devtools/SKILL.md#L62) | Prefers a throwaway browser profile and warns against attaching to the daily one | Attaching exposes every signed-in account to one injected page. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/browser-testing-with-devtools/SKILL.md#L64)) | Keeping a test browser apart from the owner's | **already have:** `plugins/playwright/skills/playwright/SKILL.md:101`, `plugins/testing/skills/run-e2e/context/e2e.md:58` | +| [`ci-cd-and-automation`, pipeline templates and deployment strategies](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/ci-cd-and-automation/SKILL.md#L56) | Sample GitHub Actions jobs, preview deploys, flags, rollback workflow, Build Cop role | Changes must not reach production unchecked. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/ci-cd-and-automation/SKILL.md#L10)) | none: no consumer has asked for a pipeline scaffold, and the owner's own pipelines are governed elsewhere | **reject:** the samples use floating action tags where our own workflow text pins by SHA (`plugins/toolchain/skills/ratchet/SKILL.md:237`), and they are boilerplate the model can write. Reopen if a consumer asks for a CI skill. The guessed gap is real but not worth filling | +| [`ci-cd-and-automation`, failures fed back to the agent](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/ci-cd-and-automation/SKILL.md#L164) | Pastes the failing log into the agent and has it fix, then push | CI results should close the loop. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/ci-cd-and-automation/SKILL.md#L166)) | Fixing a red check without weakening it | **already have:** `plugins/source-control/skills/pull-request/reference/ci-ci.md:85`, `plugins/review/agents/ci-log-auditor.md:49` | +| [`ci-cd-and-automation`, pipeline speed tree](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/ci-cd-and-automation/SKILL.md#L312) | Ordered levers for a slow pipeline | A slow pipeline tempts people to skip it. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/ci-cd-and-automation/SKILL.md#L367)) | Slow CI, measured | **already have:** `plugins/performance/skills/go-faster/reference/catalog/ci-cd.md:17-20`, `plugins/improvement/skills/find/context/ci-health.md:43` | +| [`code-review-and-quality`, five axes and severity prefixes](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L22) | One reviewer walks five dimensions and labels each comment by required action | Authors cannot tell mandatory comments from optional ones. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L193)) | Ranked, labeled review | **already have:** `plugins/review/agents/code-reviewer.md` "Output format", `plugins/review/skills/fanout/SKILL.md:32`, which split the axes among separate reviewers | +| [`code-review-and-quality`, performance axis](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L77) | A review pass for query-per-row loops, unbounded fetches and render churn | Performance problems slip in with ordinary changes. **Inference** | `plugins/review/agents/code-reviewer.md:64-83` holds no such criterion, and a search of `plugins/review` and `plugins/bugs` for those shapes finds none. No missed finding is on record | **reject:** generic knowledge with no stumble behind it (`docs/plugin-philosophy.md:982`). Reopen on a recorded miss | +| [`code-review-and-quality`, structural remedies and relocated complexity](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L88) | Each structural finding names a restructuring; a refactor is judged by how many concepts a reader still holds | A finding with no proposed move leaves the author guessing. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L90)) | Review that proposes the fix | **already have:** every smell in `plugins/review/reference/design-smells.md` "Baseline", the reviewer's default list, carries its fix; depth judgment is `/architecture:improve`. The concept count is unmeasured, so it stays out | +| [`code-review-and-quality`, flip one condition by hand](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L164) | The reviewer inverts a condition the change added, runs the suite, restores, and reports a green result as a missing test | Reading tests does not show whether they catch a regression. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L164)) | Whether tests actually check the code | **already have:** `/mutation-testing:audit` does this by tool on the diff (`plugins/mutation-testing/skills/audit/SKILL.md:2`); a read-only reviewer must not edit the tree | +| [`code-review-and-quality`, check a finding before reporting it](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L181) | Drops a finding its callers or tests rule out, separates base defects from regressions, allows an empty report | Reviews pad themselves with findings that do not hold. **Inference** | False positives and pre-existing noise | **already have:** `review:lane-verifier` refutes candidates; `plugins/review/skills/code-review/SKILL.md:218-241` excludes untouched lines no changed line calls and reports a pre-existing defect a changed line calls as advisory | +| [`code-review-and-quality`, dependency upgrades](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L296) | One package per change, read the changelog, review the lockfile diff | Bulk bumps hide which package broke the build. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L296)) | Risky update review | **already have:** `plugins/source-control/skills/pull-request/reference/dependency-ci.md:1`, `reference/prep.md:24` | +| [`code-review-and-quality`, change sizing](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L103) | Line-count bands and splitting strategies for a change | Large changes are hard to review and revert. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L105)) | Splitting a branch | **already have:** `plugins/source-control/skills/pull-request/reference/prep.md:24`, which tests independence rather than a line count; the bands are unsourced | +| [`code-simplification`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-simplification) | Behavior-preserving cleanup of recent code against a smell table, one change at a time | Working code can still be harder to read than it should be. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-simplification/SKILL.md#L12)) | Tidying a change | **already have:** the bundled `/simplify`, `plugins/code-tidying/skills/tidy-diff/SKILL.md:58`, `plugins/code-tidying/skills/tidy/SKILL.md:35`; why code exists is `/discovery:trace-intent` | +| [`constraint-driven-development`, written contract and interview](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L93) | Four defaulted questions, then one root file holding the floor, numbers, measured values and exceptions, plus lines in the agent files | Quality judgment moves from reading code into checks, and those need agreed numbers. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L14)) | Agreed bars exist, in `docs/conventions`, the paved-path file (`plugins/review/agents/code-reviewer.md`, "Before reviewing" step 1) and CI config | **reject:** a second file restating what CI config already enforces gives each value two owners (`docs/plugin-philosophy.md:503`). The guessed gap is one mechanism, split out below, not a skill | +| [`constraint-driven-development`, threshold moved](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L215) | Compares the bar against the branch point and reports only moves that loosen it; the reference reads a direction per number so tightening stays silent | Faced with a red check, an agent can make it pass by lowering the check. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L213)) | Rules forbid it for one actor (`plugins/source-control/skills/pull-request/reference/ci-ci.md:92-94`, `plugins/toolchain/skills/ratchet/SKILL.md:313`), and `plugins/review/skills/security-review/SKILL.md:215` covers merge holds only. No reviewer or check looks for a lowered coverage minimum, a rule switched off or a check dropped from a required job: a search of `plugins/review`, `testing`, `code-metrics`, `toolchain` and `verification` finds none | **already have, by measurement:** the current `code-reviewer` reported a lowered coverage minimum (`plugins/review/evals/code-reviewer-lowered-coverage-bar`) and a lint step dropped from the required CI job (`plugins/review/evals/code-reviewer-dropped-ci-step`) at their lines in 3 of 3 runs each (2026-11-03), so no criterion lands. A lint rule switched off in config was not measured | +| [`constraint-driven-development`, suppressions that switch off a relied-on check](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L217) | Singles out comments that hide code from coverage, hide a surviving mutant or silence a security scanner | Those comments disable the evidence the bar rests on. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L217)) | `/code-metrics:audit-suppressions` covers lint and type tools only (`plugins/code-metrics/skills/audit-suppressions/SKILL.md:2`, `:178`); its scanner holds no coverage or security marker, and a search of the plugin finds none | **take:** coverage-exclusion (istanbul, c8, coverage.py), Stryker mutant and security-scanner (Bandit, Semgrep, Gitleaks) directives now sit in `lib/suppression-scan.py` and its copies, each read from that tool's docs under the skill's pointer list. Stays report-only, and `/toolchain:ratchet` can hold the count | +| [`constraint-driven-development`, easier tests and unfinished work](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L216) | Flags new skips, deleted tests, removed assertions, throwing stubs and empty catches in the diff | The same cheap moves toward green. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L213)) | Test weakening and residue | **already have:** `plugins/testing/skills/setup/SKILL.md:47`, `plugins/implementation/skills/implement-dispatch/SKILL.md:131`, `plugins/code-tidying/skills/tidy-diff/reference/generated-code-residue.md:56`, `plugins/user-interface/skills/audit/reference/launch-scope.md:246` | +| [`constraint-driven-development`, ratchet and exceptions](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L233) | Records today's value as a line that must not get worse; exceptions carry an owner and expiry | An invented target stays red and teaches people to ignore red. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L235)) | Holding a count while paying it down | **already have, and ours goes further:** `plugins/toolchain/skills/ratchet/SKILL.md:18-21`, with per-file ceilings at `:141` and expiring exceptions at `:162-178` | +| [`constraint-driven-development`, tool table and default thresholds](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L245) | A numeric default and a named scanner per dimension | A user with no number still needs a working config. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L59)) | none: we deliberately ship no such number | **reject:** `plugins/code-metrics/skills/principles/SKILL.md:47` decides no standard sets a coverage figure, and restated tool defaults are what `.claude/rules/skill-bodies-state-current-rules.md` bars | +| [`constraint-driven-development`, prove an enforced row](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L189) | Runs each gate against a known violation, a clean control and a scanner error before calling it enforced | A report being generated does not enforce a number. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L189)) | Checks that cannot fail | **already have:** `plugins/corrections/skills/codify/SKILL.md:116-140` proves a check fails on old code and passes on new; `plugins/toolchain/skills/ratchet/SKILL.md:44-46` requires failing when the subject fails | +| [`constraint-driven-development`, lifecycle placement by cost](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L193) | Fast checks after each edit, slower ones at task end and in CI, scoped to the diff | Slow gates end up disabled. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L195)) | Check cost in the loop | **already have:** `docs/contracts/check-placement/README.md:3-7` (rubric and per-placement budgets), `plugins/implementation/skills/implement/SKILL.md:104` | +| [`constraint-driven-development`, how circular a check is](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L225) | Ranks checks by whether an agent could pass one with code that does not work, and requires one outside opinion | A bar made only of the agent's own tests proves little. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/SKILL.md#L231)) | Independent verification | **already have:** `plugins/autonomy/reference/guardrails/verification-topology.md:30-33`, `plugins/testing/skills/write/context/blind-author.md:3`, `plugins/source-control/skills/pull-request/reference/prep.md:49` | +| [`context-engineering`, hierarchy, packing and flooding limits](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L20) | Layers context by persistence, offers packing templates and gives line-count limits | Output quality depends on what the agent is shown. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L10)) | Context cost and instruction quality | **already have:** `plugins/context-budget/skills/audit/SKILL.md:8`, `plugins/harness-config/skills/audit-instructions/SKILL.md:18`, `/session-flow:workflow`. The line limits are unsourced figures, rejected on the same ground as the `ask-matt` figure in [`mattpocock-skills.md`](mattpocock-skills.md) | +| [`context-engineering`, restartable session boundaries](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L123) | Lists what to persist before leaving a session and what to re-read on return | Restarting loses whatever was not written down. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L125)) | Resuming work | **already have:** `plugins/session-flow/skills/handoff/SKILL.md:334` marks inherited status unverified, which upstream's list lacks | +| [`context-engineering`, recall by position in the window](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L232) | Places critical material last, citing a 2023 paper | Models recall the middle of a window less well. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L234)) | none: an agent cannot reorder its own window | **reject:** not actionable by a skill, and the source is about earlier models. UNVERIFIED on current ones | +| [`context-engineering`, conflicting and missing requirements](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L253) | Names the conflict and presents options rather than picking silently | Silent interpretation hides wrong guesses. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/context-engineering/SKILL.md#L264)) | A user decision absorbed as an assumption | **already have:** `plugins/planning/skills/interview/SKILL.md:288`, `plugins/implementation/skills/implement/SKILL.md:157-175` | +| [`debugging-and-error-recovery`, triage process](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/debugging-and-error-recovery/SKILL.md#L36) | A fixed sequence that starts from reproduction and ends with a regression test, with trees for flaky and regression cases | Guessing at fixes wastes time. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/debugging-and-error-recovery/SKILL.md#L10)) | Debugging discipline | **already have:** `plugins/debugging/skills/debug/SKILL.md:99` with its ranked loop kinds, `plugins/testing/skills/diagnose/SKILL.md:34` | +| [`debugging-and-error-recovery`, safe fallbacks](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/debugging-and-error-recovery/SKILL.md#L214) | Under time pressure, a missing config value returns a default with a warning | Crashing under pressure is worse than degrading. **Inference** | none | **reject:** it teaches the silent fallback upstream's own review skill treats as a presumptive blocker ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/code-review-and-quality/SKILL.md#L400)), and our surfaces fail closed. Upstream's own session sample now fails at startup on a missing secret ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/references/hardening-patterns.md#L36)) | +| [`debugging-and-error-recovery`, error text as data](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/debugging-and-error-recovery/SKILL.md#L272) | Reads logs and stack traces for clues and follows no step found in them | Adversarial systems can plant instructions in errors. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/debugging-and-error-recovery/SKILL.md#L274)) | Untrusted tool output | **already have:** `plugins/testing/skills/run-e2e/context/e2e.md:285`, `plugins/testing/agents/green-verifier.md:15`, `docs/contracts/untrusted-content/README.md` | +| [`deprecation-and-migration`, expand and contract](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/deprecation-and-migration/SKILL.md#L169) | Adds the new shape, dual-writes, backfills, switches reads, then drops in a later deploy | A schema changed in the same release as its code breaks during rollout. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/deprecation-and-migration/SKILL.md#L171)) | Multi-step migration without a broken state | **already have:** `plugins/work-items/skills/decompose/SKILL.md:116-130`, `plugins/coupling/skills/reduce/reference/remediations.md:75`, `plugins/planning/skills/design/SKILL.md:176`. The guessed gap does not exist. Database mechanics such as batched backfills are knowledge the model holds | +| [`deprecation-and-migration`, removal decision, notices, abandoned code](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/deprecation-and-migration/SKILL.md#L37) | Questions before deprecating, advisory versus forced removal, what to do with ownerless code | Teams build readily and remove rarely. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/deprecation-and-migration/SKILL.md#L12)) | Retiring things safely | **already have:** `plugins/planning/skills/devils-advocate/SKILL.md:38` (incumbent mode), `plugins/developer-experience/skills/build-cli/reference/cli-contract.md:64`, `docs/plugin-philosophy.md:659`, `plugins/code-tidying/skills/audit-dead-code/SKILL.md` | +| [`documentation-and-adrs`, decision records](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L23) | Follows a repository's existing record convention, else a default template and directory | Decisions lose their reasons. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L10)) | Recording decisions | **already have, and stricter:** `plugins/architecture/skills/record-decision/SKILL.md:45-47` writes nothing until a person picks a shape when no convention exists | +| [`documentation-and-adrs`, prose edit that keeps facts](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L260) | Marks details that must survive, edits, then diffs against sources | A clearer rewrite can lose a limit or add a guarantee. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L262)) | Rewrites that lose meaning | **already have:** the semantic-diff revert pass at `plugins/docs-hygiene/skills/compress/SKILL.md:33` | +| [`documentation-and-adrs`, staleness from commit order](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L268) | Compares the last commit touching a doc with the last touching its code, calls the doc stale when the code changed later, and reports "can't tell" when history gives no order | A doc still reads as authoritative after its code moves on. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L270)) | Docs that no longer match the code | **already have, by content:** `plugins/review/agents/doc-drift-detector.md:10` and `:118` check each claim against the current code, which also catches a doc edited after its code and still wrong, a case commit order calls current | +| [`documentation-and-adrs`, append-only change logs](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L283) | Adds a dated entry when correcting a doc that has a change log and never rewrites earlier entries | Git keeps the old text, but only the log keeps the reasons. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/documentation-and-adrs/SKILL.md#L283)) | Keeping why a release changed | **already have:** plugin changes land as changelog fragments that a release PR compiles (`docs/adr/0048-release-plugins-from-changelog-fragments-through-a-bot-maintained-release-pr.md`), checked by `scripts/check-changelog-parity.sh` | +| [`doubt-driven-development`, adversarial fresh reviewer](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/doubt-driven-development/SKILL.md#L87) | Hands a blank-context reviewer the artifact and contract, never the conclusion | Long sessions harden assumptions into facts. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/doubt-driven-development/SKILL.md#L10)) | Self-review bias | **already have:** `plugins/discipline/skills/scrutinize-dont-coast/SKILL.md:64-69`, `plugins/planning/skills/devils-advocate/SKILL.md:55`, `plugins/performance/skills/verify/SKILL.md:25-27` | +| [`doubt-driven-development`, keep contrary evidence in the brief](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/doubt-driven-development/SKILL.md#L85) | Withholds reasoning but includes any caller, guard or test that contradicts the claim | Stripping too much hides what the reviewer most needs. **Inference** | `plugins/discipline/skills/scrutinize-dont-coast/SKILL.md:68-70` hands over artifact and requirement only, which would drop a known contrary fact the fresh agent may never open | **adapt:** one clause in that brief and in `planning:devils-advocate`'s dispatch prompt: contrary evidence the producer already holds goes in by location, not by interpretation | +| [`doubt-driven-development`, finding classes, loop bound, zero-accept signal](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/doubt-driven-development/SKILL.md#L170) | Sorts findings in a fixed order, stops at three rounds, treats two rounds with nothing accepted as validation theater | Rubber-stamping and grinding are both failures. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/doubt-driven-development/SKILL.md#L172)) | none observed: `scrutinize-dont-coast` remediates with the user | **reject:** the round limit and the signal are unmeasured numbers, and no run of ours shows the failure | +| [`doubt-driven-development`, mandatory cross-model offer](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/doubt-driven-development/SKILL.md#L118) | Asks the user every interactive cycle whether to run another vendor's CLI | One model shares blind spots with itself. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/doubt-driven-development/SKILL.md#L116)) | Correlated blind spots | **already have, without the prompt:** `plugins/planning/skills/devils-advocate/SKILL.md:57-61`, `plugins/autonomy/reference/guardrails/verification-topology.md:57`. A question every cycle is the recurring manual step the owner rules out | +| [`frontend-ui-engineering`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/frontend-ui-engineering) | Component structure, state choices, design-system adherence, a list of generated-looking defaults, WCAG basics | Generated UI looks generated. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/frontend-ui-engineering/SKILL.md#L10)) | Interface quality | **already have, far deeper:** `plugins/user-interface/skills/design/SKILL.md:57`, `plugins/user-interface/reference/types/web/generic-defaults.md:11`, `reference/types/web/accessibility.md:11`, `/ai-slop:audit` | +| [`frontend-ui-engineering`, verify with the project's tools, follow the APG](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/frontend-ui-engineering/SKILL.md#L20) | Runs the project's own test, type and lint commands, installs nothing just to verify, says what it could not run, and follows the WAI-ARIA APG pattern for menus, dialogs, tabs, listboxes and comboboxes ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/frontend-ui-engineering/SKILL.md#L184)) | An agent adds tooling to check its own work, and hand-built widgets break keyboard use. **Inference** | Verifying interface work without side effects | **already have:** `plugins/toolchain/skills/check/SKILL.md:2` runs the project's own commands over bundled defaults, `plugins/user-interface/skills/design/SKILL.md:129-130` installs nothing without the user's yes, and `plugins/user-interface/reference/types/web/accessibility.md:56-58` and `:162-164` point at the APG | +| [`git-workflow-and-versioning`, commits and branches](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L34) | Atomic commits, typed messages, short branches, parallel worktrees, naming | Agent speed needs reviewable, reversible history. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L10)) | Commit and worktree discipline | **already have:** `plugins/source-control/skills/commit/SKILL.md:108`, `:127`, `/source-control:worktree`. Fixed naming is a convention we discover instead (`docs/plugin-philosophy.md:366`) | +| [`git-workflow-and-versioning`, save points by hard reset](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L173) | Commits each green step and resets hard on a red one | An agent off the rails should lose at most one increment. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L189)) | none | **reject:** a hard reset destroys uncommitted peer work; our nearest form is `git reset --keep` (`plugins/performance/skills/climb/SKILL.md:101`), and the `guardrails` plugin blocks destructive git | +| [`git-workflow-and-versioning`, change summary](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L191) | Lists changes, what was deliberately untouched, and open concerns | Reviewers need a map of scope. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L193)) | Stating what was skipped | **already have:** `plugins/source-control/skills/pull-request/reference/create.md:393`, `plugins/implementation/skills/implement/SKILL.md:277` | +| [`git-workflow-and-versioning`, releases and changelogs](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L270) | Semantic versions, tags as truth, a curated changelog | Consumers need to know what changed. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/git-workflow-and-versioning/SKILL.md#L272)) | Release notes | **already have:** `docs/adr/0048-release-plugins-from-changelog-fragments-through-a-bot-maintained-release-pr.md`, `scripts/check-changelog-parity.sh` | +| [`idea-refine`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/idea-refine) | Diverges through named lenses and frameworks, converges on directions, writes a one-pager with an exclusions list | Vague ideas need shaping before planning. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/idea-refine/SKILL.md#L14)) | Diverging before scope | **already have:** `plugins/planning/skills/brainstorm/SKILL.md:62-73` (non-code candidates too), `:114` for rejected options, `/planning:devils-advocate` for assumptions. The framework catalog is reference the model already knows | +| [`incremental-implementation`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/incremental-implementation) | Thin slices, each tested and committed, with simplicity and scope rules | Whole-feature passes hide which change broke things. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/incremental-implementation/SKILL.md#L10)) | Execution discipline | **already have:** `plugins/implementation/skills/implement/SKILL.md:104-105`, `:277`, `plugins/work-items/skills/decompose/SKILL.md:116` | +| [`interview-me`, pacing, restate and confirmation](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/interview-me/SKILL.md#L53) | Single-question pacing with a guess attached, a structured restate, an unhedged yes | The cheapest time to find the gap between ask and want is before work starts. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/interview-me/SKILL.md#L12)) | Shared understanding before work | **already have:** `plugins/planning/skills/interview/SKILL.md:176` (pacing is configurable), `:208`, `plugins/planning/skills/interview/actions/restate.md:32-33`, with a recommendation in place of a guess | +| [`interview-me`, convention-shaped and delegated answers](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/interview-me/SKILL.md#L79) | When an answer sounds like best practice, asks what the person would want with nobody to justify it to; a reply that hands the choice back is not a decision | Respectable-sounding answers can mask the real want. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/interview-me/SKILL.md#L81)) | `plugins/planning/skills/interview/SKILL.md:208` handles doubt and `context/loop.md:385` handles departures, but neither covers an answer made of buzzwords or one delegating a real decision; a search of both files finds no rule for it | **adapt:** one line beside "Hedged flag" in `context/loop.md` holding such a reply `open` with a concrete choice restated. An item an agent may settle stays settled, so this applies only to rows that are the user's | +| [`interview-me`, confidence figure and predict-the-next-three test](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/interview-me/SKILL.md#L132) | A self-reported percentage and a stop test based on predicting the user's reactions | A vibe needs a checkable stop. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/interview-me/SKILL.md#L140)) | Knowing when an interview is done | **already have, more checkable:** the register gate and assumption sweep at `plugins/planning/skills/interview/SKILL.md:318`. A self-reported figure measures nothing | +| [`observability-and-instrumentation`, skill as a whole](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation) | Signal choice, structured logs, rate and resource metrics, tracing, symptom alerts, runbooks | Telemetry added after launch makes the first bug a dig through history. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation/SKILL.md#L10)) | The guessed gap is real for product telemetry: no skill owns it, and `plugins/autonomy/reference/telemetry.md` and `/harness-ops:observability` cover pipelines and Claude Code only | **reject as a skill:** textbook content the model has, tied to volatile vendor tooling, with no recorded stumble (`docs/plugin-philosophy.md:982`). One mechanism is split out below. Reopen on a repeated miss | +| [`observability-and-instrumentation`, start from operator questions](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation/SKILL.md#L27) | Writes what a responder will ask first and maps each signal to a question | Telemetry with no question behind it is clutter. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation/SKILL.md#L29)) | Stating what must be visible | **already have:** `plugins/planning/skills/interview/context/nfr-prompts.md:17`, `plugins/planning/skills/design/SKILL.md:276` | +| [`observability-and-instrumentation`, prove the telemetry](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation/SKILL.md#L190) | Induces a failure and locates it through telemetry alone, without reading source; fires each alert once | Instrumentation is code and can be silently wrong. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation/SKILL.md#L192)) | `plugins/verification/skills/confirm/context/outcome.md:115-121` lists the proof per kind of change and has no row for logs, metrics or alerts; `plugins/verification/skills/confirm/SKILL.md:169` only routes those paths to e2e | **adapt:** one table row there: the check that proves a telemetry change is forcing the failure and finding it in the sink by its id; a log call that compiles is not enough | +| [`observability-and-instrumentation`, field naming the entry point](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation/SKILL.md#L91) | Records which caller started a run, beside the run's id | A shared log with several callers can only be attributed by elimination. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/observability-and-instrumentation/SKILL.md#L91)) | none recorded | **reject:** a sound idea, but with no surface to host it once the skill is rejected. `plugins/autonomy/reference/telemetry.md:11` already pins semantic conventions for our own pipeline | +| [`performance-optimization`, keep or revert and attempt log](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/performance-optimization/SKILL.md#L139) | Re-measures the same way, compares with noise, reverts a neutral change, logs reverted ideas | Unmeasured changes land and stay as cost. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/performance-optimization/SKILL.md#L158)) | Measured optimization | **already have, enforced by script:** `plugins/performance/skills/climb/SKILL.md:73-108`, `plugins/performance/skills/verify/SKILL.md:101-139`, `plugins/verification/skills/measure/SKILL.md:96-98`. The guessed gap does not exist | +| [`performance-optimization`, bottleneck catalog and budgets](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/performance-optimization/SKILL.md#L121) | Fix patterns for query plans, pools, caches, images, bundles, and fixed budget numbers | The usual suspects recur. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/performance-optimization/SKILL.md#L123)) | none: `plugins/performance/skills/target/SKILL.md:41` ranks targets by measured evidence | **reject:** a catalog the model knows, and the budgets are unsourced figures. Query plans already appear as a loop kind at `plugins/debugging/skills/debug/SKILL.md:224` | +| [`performance-optimization`, cache key omits the viewer](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/performance-optimization/references/optimization-patterns.md#L238) | Requires every input that varies the response in the key, since leaving out the user serves one person's data to another | A data leak can ship looking like a speedup. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/performance-optimization/references/optimization-patterns.md#L238)) | `plugins/review/agents/security-reviewer.md:60` lists access-control checks with no cache case; a search of `plugins/review/context` and `plugins/bugs` for it finds none, and `plugins/review/skills/quality-gate/context/downstream.md:169` treats a cache key only as a shape | **already have, by measurement:** the current `security-reviewer` reported the cross-account cache at its line in 3 of 3 runs (`plugins/review/evals/security-reviewer-cache-key-omits-viewer`, 2026-11-03), so no text lands | +| [`planning-and-task-breakdown`, breakdown](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/planning-and-task-breakdown/SKILL.md#L22) | Read-only planning, dependency graph, vertical slices, sized tasks, checkpoints | Task breakdown separates reliable agents from tangled output. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/planning-and-task-breakdown/SKILL.md#L10)) | Planning and slicing | **already have:** `plugins/planning/skills/plan/SKILL.md:30`, `:64`, `plugins/work-items/skills/decompose/SKILL.md:100`, `:116`. Upstream's file-count sizing is weaker than fresh-context sizing | +| [`planning-and-task-breakdown`, never overwrite an unfinished plan](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/planning-and-task-breakdown/SKILL.md#L150) | Stops and asks before replacing plan files that still hold open tasks | One fixed path lets sessions destroy each other's state. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/planning-and-task-breakdown/SKILL.md#L153)) | The collision itself | **already have, by structure:** plans live per topic under `plugins/planning/reference/artifact-protocol.md:14`, so two efforts do not share a path. A same-topic rewrite was not separately checked | +| [`security-and-hardening`, controls and OWASP baseline](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L75) | Hardening rules per area with worked patterns in a reference file | External input should be treated as hostile. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L10)) | Security review of a change | **already have:** `plugins/review/agents/security-reviewer.md:56-69`, `plugins/review/context/security-web-api.md`, `/review:security-review`, the `claude-security` scan | +| [`security-and-hardening`, threat model with STRIDE](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L21) | Maps boundaries and assets and runs a six-way lens per boundary | Hardening with no picture of the attacker is guesswork. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L23)) | Design-level threats | **already have:** `plugins/review/agents/security-reviewer.md:63` flags design review, and `plugins/review/skills/quality-gate/context/security.md:30` routes threat-model depth elsewhere. The lens is common knowledge | +| [`security-and-hardening`, features that call a model](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L154) | Model output handled as untrusted input, permissions enforced in code, secrets kept out of context, tool scope and consumption limits | Calling a model opens a new attack surface. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L156)) | `plugins/review/agents/security-reviewer.md:38-44` has no row for this surface and a search of `plugins/review/agents`, `context` and the security-review skill finds no model-output or prompt-injection check. `docs/contracts/untrusted-content/README.md` guards our agents, not a consumer's product | **already have, by measurement:** the current `security-reviewer` named the defect in 6 of 6 runs (3 on 2026-11-03 baseline, 3 on rerun); the rerun cited diff-file lines because the fixture supplies a diff, not the source tree. The grader counted 2 of the 3 reruns, missing the one that cited the range `42-47` (`plugins/review/evals/security-reviewer-llm-output-trusted`), so no surface row or `context/security-llm.md` lands | +| [`security-and-hardening`, destructive operations on derived paths](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L115) | Before a delete, requires the resolved target under an allowed root, below it, with ownership evidence, and states why even that can fail | A value's channel says nothing about who wrote it, and a shape check is mistaken for authorization. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L117)) | `guardrails` `block-root-delete-target` and `plugins/disk-hygiene/skills/clean/reference/safety-model.md:92` protect our own agents. Review of a consumer's cleanup code stops at traversal (`plugins/review/agents/security-reviewer.md:60`) | **already have, by measurement:** the current `security-reviewer` reported the shape-checked delete reaching outside its root in 3 of 3 runs, two at source lines and one at the diff-file lines they map to (`plugins/review/evals/security-reviewer-delete-shape-check`, 2026-11-03), so no text lands | +| [`security-and-hardening`, dependency scripts and new packages](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L133) | Blocks install scripts before first execution, triages by reachability, reviews new packages since advisories miss fresh malice | A clean audit is not proof a package is safe. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L138)) | `plugins/toolchain/skills/check/SKILL.md:114` already installs with scripts off, but the review floor at `plugins/review/agents/security-reviewer.md:65` is an audit command only, and `plugins/review` holds no install-script or typosquat check | **already have, by measurement:** the current `security-reviewer` reported the look-alike package and its install script in 3 of 3 runs (`plugins/review/evals/security-reviewer-new-dependency-unread`, 2026-11-03), so no text lands. The runs had no shell, so the audit command could not run and the stop-at-the-audit failure was not exercised | +| [`security-and-hardening`, personal data](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L142) | Classify, minimize, set retention, support export and deletion | Hardening does not ask whether to hold the data at all. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L144)) | none beyond `plugins/review/agents/security-reviewer.md:68` | **reject:** generic, jurisdiction-dependent, and no consumer has asked | +| [`security-and-hardening` and `references/security-checklist.md`, OWASP Top 10:2025 numbering](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L220) | Moves every OWASP citation to the 2025 edition and cites each id with its year | The 2021 and 2025 editions number several categories differently, so an id without a year is ambiguous. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L220)) | `plugins/review/agents/security-reviewer.md:62-75` keeps the 2021 list without naming the edition. Under the [OWASP Top 10:2025](https://owasp.org/Top10/2025/) its A04, A06 and A10 ids name other categories, SSRF now sits inside A01, and A10:2025 Mishandling of Exceptional Conditions has no row | **adapt, not yet applied:** name the edition in that table and move it to the 2025 ids, which changes no check. A row for A10:2025 is a new check class, so it waits for a recorded miss under the eval-first decision above | +| [`shipping-and-launch`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/shipping-and-launch) | Launch checklist, flag lifecycle, staged percentages, numeric rollback thresholds, an error budget gate | Releases need a way back and a way to watch them. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/shipping-and-launch/SKILL.md#L10)) | none for this marketplace: plugins ship through a release PR; a consumer's rollout is covered at `plugins/planning/skills/prd/context/templates.md:262-263` and `plugins/performance/reference/techniques.md:654` | **reject:** the threshold table and budget bands carry no source, so they are unearned numbers. `plugins/autonomy/reference/routines.md:250` keeps deploy verification until a telemetry connector exists | +| [`source-driven-development`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/source-driven-development) | Detects versions, fetches the exact docs page, cites every framework choice, flags what it could not verify | Training data goes stale. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/source-driven-development/SKILL.md#L10)) | Grounding in live docs | **already have:** `plugins/discovery/skills/read-docs/SKILL.md:24`, `:48`, `plugins/context7/skills/lookup/SKILL.md:24`, `/discipline:do-your-research`, `docs/standards/source-authority-tiers.md:27-29` | +| [`spec-driven-development`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development) | Capability map for bundled requests, a six-part spec, staged approvals, and a stop after writing | Building before requirements are written invites rework. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development/SKILL.md#L10)) | Locking intent and splitting a large effort | **already have:** `plugins/planning/skills/interview/SKILL.md:288`, `plugins/planning/skills/prd/SKILL.md:63`, `plugins/planning/skills/wayfind/SKILL.md:9`, `plugins/work-items/skills/decompose/SKILL.md:100-116` | +| [`spec-driven-development`, version label and deferred list](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development/SKILL.md#L232) | Titles the spec with the version it describes and keeps ideas cut from that version in an Out of Scope (Deferred) section | Ideas that arrive mid-build otherwise grow the current version. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development/SKILL.md#L236)) | Holding scope during a build | **already have:** `plugins/planning/skills/prd/SKILL.md:177` keeps a Non-goals section and `:193` separates a deferral from a permanent rejection, which goes to a rejected-concept ledger. A version in the title adds nothing the PRD's `locked` status (`:166`) does not | +| [`spec-driven-development`, delta spec for a shipped feature](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development/SKILL.md#L238), with the [`/spec` delta flow](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/spec.md#L22) | A change to a shipped spec gets its own small spec with a `Status:` line, and the outcome is folded into the original after it ships | A hand-edit of a shipped spec loses a separate review of the change. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development/SKILL.md#L240)) | Changing something after it ships | **already have, differently:** `plugins/work-items/skills/decompose/context/re-decompose.md:65-68` opens a new spec for a change after ship and never edits the closed one. We do not fold the change back, since a closed container is never edited into a living doc | +| [`test-driven-development`, cycle, test choice and doubles](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L38) | Red-green-refactor, a failing test for each bug, a double preference order, stack discovery | Seeming right is not proof. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L10)) | Test discipline | **already have:** `plugins/tdd/skills/principles/SKILL.md:41-51`, `plugins/testing/skills/write/SKILL.md:96`, `plugins/implementation/skills/implement/SKILL.md:105` | +| [`test-driven-development`, percentages for test levels](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L144) | A pyramid with fixed shares per level | Effort should go to fast tests. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L146)) | none | **reject:** unsourced shares; our position comes from named sources through `/tdd:principles` | +| [`test-driven-development`, crash and rollback at the real boundary](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L248) | Tests a crash or rollback against the real thing, since a thrown error is not process death and a mocked call is not a transaction | Doubles can pass while durability is broken. **Inference** | `plugins/tdd/skills/principles/reference/test-doubles.md` has a Crash Test Dummy section at `:65` about a different thing, and `tdd` and `testing` hold no such rule | **take:** one line in `/testing:test-value` or `test-doubles.md`, as a case where a double cannot be the oracle | +| [`test-driven-development`, reproduction written apart from the fix](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L345) | A subagent writes the failing test with no knowledge of the fix | A test written beside its fix can fit the fix. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L359)) | Tests independent of the implementation | **already have:** `plugins/testing/skills/write/context/blind-author.md:3` | +| [`test-driven-development` and others, no repeat of a clean run](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L400) | Forbids rerunning a command on unchanged code | Repeating a clean run adds no confidence. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/test-driven-development/SKILL.md#L400)) | none recorded; a search of our catalog and verification skills finds no such line and no stumble | **reject:** cheap to add but ungrounded here. Reopen if `/session-flow:audit-friction` reports it | +| [`using-agent-skills`, router](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/using-agent-skills/SKILL.md#L12) | A meta-skill that maps a task to a skill by phase | Agents need to find the right workflow. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/using-agent-skills/SKILL.md#L10)) | Finding the fitting skill | **reject as a router, already have as help:** router skills are rejected in the decomposition table of [`mattpocock-skills.md`](mattpocock-skills.md); `/session-flow:recommend-skills` and `/discipline:use-your-skills` cover the need | +| [`using-agent-skills`, standing behaviors](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/using-agent-skills/SKILL.md#L45) | Always-on rules on assumptions, confusion, pushback, simplicity, scope, verification | The usual failures look like productivity. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/using-agent-skills/SKILL.md#L118)) | Same drifts | **already have:** the correctors under `plugins/discipline/skills/`, and `plugins/playbooks/skills/fable-5/SKILL.md`. Always-on restatement fails instruction economy (`docs/plugin-philosophy.md:963`) | +| [Rationalization and red-flag tables across skills](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/CONTRIBUTING.md#L51) | Every skill lists excuses for skipping with a rebuttal, plus warning signs | Agents argue themselves out of a process. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/CONTRIBUTING.md#L51)) | none measured: `docs-hygiene:write-for-agents` budgets every loaded line | **reject:** no with-and-without measurement upstream or here; pressure cases below test the same worry directly | +| [`agents/code-reviewer.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/code-reviewer.md) | A five-dimension reviewer persona with a verdict template | Thorough review before merge. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/code-reviewer.md#L8)) | Reviewer agent | **already have:** `plugins/review/agents/code-reviewer.md`. Mandatory praise is left out on purpose | +| [`agents/security-auditor.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/security-auditor.md) | A security persona with severity bands and an exploit scenario per serious finding | Practical, exploitable risk. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/security-auditor.md#L8)) | Security reviewer agent | **already have:** `plugins/review/agents/security-reviewer.md:71-84`; its model-feature section is the adapt row above | +| [`agents/test-engineer.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/test-engineer.md) | A test strategy persona with a scenario table and coverage report | Designing and judging suites. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/test-engineer.md#L8)) | Coverage gaps | **already have:** `plugins/testing/skills/plan/SKILL.md:35`, `plugins/testing/skills/write/SKILL.md:96` | +| [`agents/web-performance-auditor.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/web-performance-auditor.md) | Audits from source or from lab and field artifacts, labels each value's origin, reports unmeasured values as unmeasured | A model reading source cannot measure user timings. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/agents/web-performance-auditor.md#L43)) | Honest measurement of web speed | **already have:** `plugins/verification/skills/measure/SKILL.md:98`, `plugins/user-interface/skills/audit/reference/launch-scope.md:460-466`, `plugins/user-interface/skills/glossary/reference/engineering.md:430`, `plugins/testing/skills/run-e2e/context/e2e.md:60`. The guessed gap does not exist; the API checklist inside restates vendor features | +| [`references/definition-of-done.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/definition-of-done.md) | A fixed checklist beside per-task acceptance criteria | Acceptance alone leaves work unfinished. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/definition-of-done.md#L15)) | A done check | **already have:** `plugins/verification/skills/confirm/SKILL.md`, `/review:quality-gate`, which run rather than list | +| [`references/performance-checklist.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/performance-checklist.md) | A web and backend tick list with fixed numbers | Quick reference for the performance skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/performance-checklist.md#L3)) | none | **reject:** restated vendor thresholds, and `plugins/user-interface/reference/types/web/performance.md` covers the interface half by pointer | +| [`references/accessibility-checklist.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/accessibility-checklist.md) | A WCAG tick list with patterns | Quick reference for the UI skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/accessibility-checklist.md#L3)) | Accessibility review | **already have:** `plugins/user-interface/reference/types/web/accessibility.md` | +| [`references/testing-patterns.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/testing-patterns.md) | JavaScript test syntax examples | Illustrates the test skill's principles. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/testing-patterns.md#L3)) | none | **reject:** framework syntax the model knows | +| [`references/observability-checklist.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/observability-checklist.md) | A tick-list form of the observability skill | Quick reference for that skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/observability-checklist.md#L3)) | none beyond the rows above | **reject:** follows the skill's verdict | +| [`references/orchestration-patterns.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/orchestration-patterns.md) | Endorsed multi-agent shapes and anti-patterns, including debate by agent team | Coordination layers add cost and lose context. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/orchestration-patterns.md#L292)) | Choosing how to run agents | **already have:** `docs/plugin-philosophy.md` Delegation mechanics, `/multi-agent:assess`. Agent teams stay deferred (`docs/plugin-philosophy.md:306`), and debate conflicts with isolated aggregation at `plugins/autonomy/reference/guardrails/verification-topology.md:241-246`. Its model and platform claims are volatile | +| [`references/security-checklist.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md) | A tick list, an install-script policy matrix by manager version and a path containment sample | Quick reference for the security skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L3)) | Covered by the security rows above | **reject:** the matrix says itself that it ages quickly ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L167)), so we point at each manager's docs instead | +| [`hooks/SDD-CACHE.md` and its scripts](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/hooks/SDD-CACHE.md) | Caches WebFetch results, revalidating with the origin before each reuse | The same docs get fetched each session, and a plain cache hides change. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/hooks/SDD-CACHE.md#L7)) | Cheap, fresh docs reads | **already have, better:** `plugins/performance/scripts/docs-cache.sh:27`, `:439` and `docs/adr/0057-share-a-user-scope-docs-cache-across-plugins.md` store raw bytes. Upstream stores one agent's summary under a key that ignores the prompt | +| [`hooks/SIMPLIFY-IGNORE.md` and `simplify-ignore.sh`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/hooks/SIMPLIFY-IGNORE.md) | Rewrites marked blocks to placeholders on disk during a session so the model cannot see them | Some code must not be simplified. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/hooks/SIMPLIFY-IGNORE.md#L3)) | none: a comment stating why plus review protects such code | **reject:** it changes tracked files on Read and relies on a Stop event to restore them, so a crash or a parallel session sees placeholders, a risk its own document describes ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/hooks/SIMPLIFY-IGNORE.md#L73)) | +| [`hooks/session-start.sh`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/hooks/session-start.sh) | Injects the meta-skill at session start, on hosts with no native routing | Hosts with no router need one. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/hooks/session-start.sh#L5)) | none: Claude Code routes natively | **reject:** upstream itself leaves it unwired for Claude Code | +| [`.claude/commands/` spec, plan, test, review, code-simplify](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands) | Thin user-invoked wrappers over skills | Named entry points for each phase. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/orchestration-patterns.md#L32)) | none | **reject:** the `commands/` surface is prohibited here (`docs/plugin-philosophy.md:328`) and each maps to a skill we ship | +| [`/build` default](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/build.md#L15) | Next task, test first, commit, stop | One careful slice at a time. **Inference** | Executing one step | **already have:** `plugins/implementation/skills/implement/SKILL.md:105`, `/work-items:work` | +| [`/build auto`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/build.md#L28) | One approval, then all tasks, prerequisites first, each with its own commit, stopping on ambiguity or irreversible steps | Stepping between tasks by hand is the cost being removed. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/build.md#L30)) | Running a whole plan unattended | **already have, stronger:** `plugins/implementation/skills/implement-dispatch/SKILL.md:131` verifies each return against direct evidence, `/work-items:ship run` lands in parallel, worktrees give the clean baseline, and `plugins/planning/skills/interview/SKILL.md:208` covers hedged approval | +| [`/build auto`, spec choice and source-spec guard](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/build.md#L32) | Prefers an unimplemented delta spec, writes a `Source spec:` line into the plan ([plan template](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/planning-and-task-breakdown/SKILL.md#L171)), and stops when an existing plan names another spec | A plan generated from one spec must not run against another. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/build.md#L34)) | Running the wrong plan | **already have, by structure:** plans live per topic slice (`plugins/planning/reference/artifact-protocol.md:14`), so two specs never share one plan file; the same ground as the unfinished-plan row | +| [`/constraints`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/constraints.md) | Setup plus check, guard and ratchet subcommands | Entry point to the constraints skill. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/constraints.md#L2)) | Covered by the constraint rows above | **reject:** follows those rows; `ratchet` is `/toolchain:ratchet`, `guard` is the adapt rows | +| [`/ship`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/ship.md) | Runs three reviewers at once and merges them into a release verdict plus a rollback plan | Pre-launch needs several independent views. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/ship.md#L8)) | Breadth review and merge gating | **already have:** `plugins/review/skills/fanout/SKILL.md:2`, `plugins/source-control/skills/pull-request/SKILL.md`. A fixed line and file bypass is weaker than the work-class door | +| [`/webperf`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/webperf.md) | Chooses a source-only or an artifact-backed audit and spawns the persona | A web-only pass, out of the general fan-out. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude/commands/webperf.md#L6)) | Web speed audit | **already have:** `plugins/user-interface/skills/audit/SKILL.md:3` takes a concern lane, `plugins/user-interface/reference/types/web/performance.md`. See the persona row | +| [`evals/README.md`, lexical routing tier](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L22) | Scores prompts against all descriptions with TF-IDF in CI, with a collision check | Descriptions miss users' words or overlap. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L22)) | Trigger quality | **already have:** `plugins/skill-quality/skills/check/SKILL.md:227`, near-miss probes at `plugins/playbooks/skills/skill-authoring/reference/skill-criteria.md:254-257`. Upstream's pairwise collision error has no counterpart, and `:273` already holds a lexical score to tripwire status | +| [`evals/README.md`, description clause for pasted requests](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L71) | Records that models answer a request directly when the content is pasted in, and that naming that shape in a description raised skill firing without new false fires; a later rerun shows the result is tied to a CLI version, and later paragraphs add that the answer may look quick or obvious from reading the pasted content ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L83)) | A capable model skips a skill when the job looks easy. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L71)) | `plugins/playbooks/skills/skill-authoring/reference/skill-criteria.md:254-257` builds probes from plain queries and near-misses, with no pasted-content class; a search of skill bodies and eval prompts finds no description using such a clause | **adapt:** add pasted-content probes, including requests whose answer looks obvious from the pasted text, to the frozen set in `skill-criteria.md`, measured through `/skill-quality:check measure-invocation`. Copy no upstream rate, and change a description only on our own measured gain, because [the rerun](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L77) shows these numbers do not last | +| [`evals/README.md`, pressure cases](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L49) | Eval cases whose prompt pushes against a procedure through urgency, sunk cost or rank | A process that holds only when nobody pushes is not much of a process. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L49)) | `plugins/evals/skills/design/SKILL.md:183-185` lists routing, happy path, guardrail and anti-pattern; a search of `plugins/evals/skills` and the authoring skill finds no such class, though single cases exist (`plugins/source-control/evals/pull-request-ci-mode-escalates-instead-of-weakening-test`) | **take:** name it as a case kind in that list, for skills that hold a procedure | +| [`evals/plugin/` and the behavioral tier](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/evals/plugin) | Paired fires and stays-quiet cases graded in two arms, plugin on and off; only completed runs reach the grader | Firing is not the same as helping. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/README.md#L69)) | Measuring what a skill adds | **already have:** `plugins/evals/skills/plugin-eval/SKILL.md:2`, `plugins/evals/skills/plugin-eval/reference/iterating.md:5`, `:17`, `plugins/evals/skills/design/SKILL.md:199-203` | +| [`evals/skill-impact.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/skill-impact.md) | An append-only list of proposals rejected on eval evidence, currently empty | Contributors repeat rejected work. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/evals/skill-impact.md#L3)) | Remembering rejected ideas | **already have:** these `docs/upstream/` records, and the ledger in `/work-items:triage` | +| [`scripts/lib/skill-lint.js`, `validate-skills.js`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/lib/skill-lint.js) | Lints frontmatter, naming, required sections and a line budget | Rules kept in one tested place. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/lib/skill-lint.js#L5)) | Skill linting | **already have:** `/skill-quality:check`. Upstream's top-level key allowlist would flag frontmatter we use by design | +| [`scripts/run-evals.js`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/run-evals.js) | A custom runner for the routing and behavioral tiers | Predates or sits beside the host's evaluator. **Inference** | Running evals | **already have:** `claude plugin eval` through `/evals:plugin-eval`; native-first rules out a custom runner (`docs/plugin-philosophy.md:285`) | +| [`scripts/validate-reference-links.js`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/validate-reference-links.js) | Checks skill links to reference files and their heading anchors | Agents stalled on links that resolved nowhere. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/validate-reference-links.js#L8)) | Dead references | **already have:** `skill-reference-verify` and `stale-path-verify` in `plugins/guardrails/README.md:106-107`, `scripts/check-line-citations.py`. Heading anchors are not a citation target here (`docs/plugin-philosophy.md:495`) | +| [`scripts/validate-artifact-paths.js`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/validate-artifact-paths.js) | Forces producers and consumers of the plan files to agree on paths | Moving an artifact broke the pipeline silently. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/validate-artifact-paths.js#L5)) | Artifact agreement across lifecycle plugins | **already have:** `plugins/planning/reference/artifact-protocol.md:31`, `docs/plugin-artifact-protocol.md:7` | +| [`scripts/validate-commands.js`, Gemini and Antigravity command copies](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/validate-commands.js) | Keeps three harness copies of each command in step | Copies drift. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/validate-commands.js#L5)) | none: one harness, per the Codex finding in [`mattpocock-skills.md`](mattpocock-skills.md) | **reject** | +| [`scripts/validate-versions.js`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/validate-versions.js) | Compares version fields across manifests | Manifests disagree. **Inference** | Version drift | **already have:** `scripts/check-changelog-parity.sh`, and `version` lives in one manifest (`docs/plugin-philosophy.md:465`) | +| [`scripts/staged-secret-scan-test.js`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/staged-secret-scan-test.js) | Runs each documented secret-scan command against a fixture to prove it names the file and never prints the value | A scan that printed matches leaked the credential into agent logs. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/staged-secret-scan-test.js#L8)) | Secret leakage by scanners | **already have:** `plugins/guardrails/git-hooks/content-scan.sh:159` reports file, line and pattern label with no matched value, with a sibling test file. We ship the scan as a tested script, not a command in prose | +| [`scripts/floor-guard-reference-test.js`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/scripts/floor-guard-reference-test.js) and [`skills/constraint-driven-development/references/floor-guard.md`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/references/floor-guard.md) | Executes a code block extracted from a document against fixtures; the block is a regex diff guard | Agents otherwise write their own guard each run. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/references/floor-guard.md#L3)) | none: our checks are files with sibling tests, not prose | **reject:** the guard's parts already live in the surfaces named in the constraint rows; a regex over `TODO` and removed assert lines would be noisy as a gate | +| [`skills/constraint-driven-development/scripts/quality-gate.mjs`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/scripts/quality-gate.mjs) | Parses a scanner report and fails on an incomplete or empty scan as well as on severity | Some scanners exit clean on findings, and an error page can look like a clean scan. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/constraint-driven-development/scripts/quality-gate.mjs#L26)) | A check that cannot tell an unread target from a clean one | **already have, as a rule:** `plugins/toolchain/skills/ratchet/SKILL.md:44-46`, `plugins/review/agents/ci-log-auditor.md:49`. No scanner wrapper ships because consumers own their scanners | +| [`.github/ISSUE_TEMPLATE/skill-gap.yml`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.github/ISSUE_TEMPLATE/skill-gap.yml) | An issue form for guidance that misled an agent | Field reports on wrong guidance. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.github/ISSUE_TEMPLATE/skill-gap.yml#L2)) | none: agents and bots file here, and `/bugs:write` owns the form | **reject** | ## License notice -The [LICENSE file at the pin](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/LICENSE) +The [LICENSE file at the pin](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/LICENSE) is the MIT license (copyright 2025 Addy Osmani). The `license` field reads `MIT` in all three -manifests, [`plugin.json`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/plugin.json), -[`.claude-plugin/plugin.json`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.claude-plugin/plugin.json) -and [`.codex-plugin/plugin.json`](https://github.com/addyosmani/agent-skills/blob/301b02b12bff98e4688e6984af6556802322bbde/.codex-plugin/plugin.json), +manifests, [`plugin.json`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/plugin.json), +[`.claude-plugin/plugin.json`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.claude-plugin/plugin.json) +and [`.codex-plugin/plugin.json`](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/.codex-plugin/plugin.json), and GitHub reports MIT (`gh api repos/addyosmani/agent-skills --jq .license.spdx_id`). They do not disagree. No upstream text or code is copied here, and a row that lands writes its own words from the mechanism. - **Pointer**: the LICENSE file linked above, at the pin -- **As of**: 2026-11-02 +- **As of**: 2026-11-16 - **Recheck trigger**: the license file or a manifest's `license` field changes From 67e1092de2dcb19a883990781c92ab6bc88896bd Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Mon, 16 Nov 2026 03:29:58 -0500 Subject: [PATCH 2/2] docs(upstream): name every OWASP id the 2025 list renumbers The OWASP 2025 row said only A04, A06 and A10 name other categories. Against the published 2025 list, A02 through A06 and A10 do. Co-Authored-By: Claude Fable 5.2 --- docs/upstream/addyosmani-agent-skills.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/upstream/addyosmani-agent-skills.md b/docs/upstream/addyosmani-agent-skills.md index c1969622bf4..f27722b6a57 100644 --- a/docs/upstream/addyosmani-agent-skills.md +++ b/docs/upstream/addyosmani-agent-skills.md @@ -99,7 +99,7 @@ recorded miss. The PR that settles a row edits that row. | [`security-and-hardening`, destructive operations on derived paths](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L115) | Before a delete, requires the resolved target under an allowed root, below it, with ownership evidence, and states why even that can fail | A value's channel says nothing about who wrote it, and a shape check is mistaken for authorization. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L117)) | `guardrails` `block-root-delete-target` and `plugins/disk-hygiene/skills/clean/reference/safety-model.md:92` protect our own agents. Review of a consumer's cleanup code stops at traversal (`plugins/review/agents/security-reviewer.md:60`) | **already have, by measurement:** the current `security-reviewer` reported the shape-checked delete reaching outside its root in 3 of 3 runs, two at source lines and one at the diff-file lines they map to (`plugins/review/evals/security-reviewer-delete-shape-check`, 2026-11-03), so no text lands | | [`security-and-hardening`, dependency scripts and new packages](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L133) | Blocks install scripts before first execution, triages by reachability, reviews new packages since advisories miss fresh malice | A clean audit is not proof a package is safe. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L138)) | `plugins/toolchain/skills/check/SKILL.md:114` already installs with scripts off, but the review floor at `plugins/review/agents/security-reviewer.md:65` is an audit command only, and `plugins/review` holds no install-script or typosquat check | **already have, by measurement:** the current `security-reviewer` reported the look-alike package and its install script in 3 of 3 runs (`plugins/review/evals/security-reviewer-new-dependency-unread`, 2026-11-03), so no text lands. The runs had no shell, so the audit command could not run and the stop-at-the-audit failure was not exercised | | [`security-and-hardening`, personal data](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L142) | Classify, minimize, set retention, support export and deletion | Hardening does not ask whether to hold the data at all. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/security-and-hardening/SKILL.md#L144)) | none beyond `plugins/review/agents/security-reviewer.md:68` | **reject:** generic, jurisdiction-dependent, and no consumer has asked | -| [`security-and-hardening` and `references/security-checklist.md`, OWASP Top 10:2025 numbering](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L220) | Moves every OWASP citation to the 2025 edition and cites each id with its year | The 2021 and 2025 editions number several categories differently, so an id without a year is ambiguous. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L220)) | `plugins/review/agents/security-reviewer.md:62-75` keeps the 2021 list without naming the edition. Under the [OWASP Top 10:2025](https://owasp.org/Top10/2025/) its A04, A06 and A10 ids name other categories, SSRF now sits inside A01, and A10:2025 Mishandling of Exceptional Conditions has no row | **adapt, not yet applied:** name the edition in that table and move it to the 2025 ids, which changes no check. A row for A10:2025 is a new check class, so it waits for a recorded miss under the eval-first decision above | +| [`security-and-hardening` and `references/security-checklist.md`, OWASP Top 10:2025 numbering](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L220) | Moves every OWASP citation to the 2025 edition and cites each id with its year | The 2021 and 2025 editions number several categories differently, so an id without a year is ambiguous. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/references/security-checklist.md#L220)) | `plugins/review/agents/security-reviewer.md:62-75` keeps the 2021 list without naming the edition. Under the [OWASP Top 10:2025](https://owasp.org/Top10/2025/) its A02 to A06 and A10 ids name other categories, SSRF now sits inside A01, and A10:2025 Mishandling of Exceptional Conditions has no row | **adapt, not yet applied:** name the edition in that table and move it to the 2025 ids, which changes no check. A row for A10:2025 is a new check class, so it waits for a recorded miss under the eval-first decision above | | [`shipping-and-launch`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/shipping-and-launch) | Launch checklist, flag lifecycle, staged percentages, numeric rollback thresholds, an error budget gate | Releases need a way back and a way to watch them. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/shipping-and-launch/SKILL.md#L10)) | none for this marketplace: plugins ship through a release PR; a consumer's rollout is covered at `plugins/planning/skills/prd/context/templates.md:262-263` and `plugins/performance/reference/techniques.md:654` | **reject:** the threshold table and budget bands carry no source, so they are unearned numbers. `plugins/autonomy/reference/routines.md:250` keeps deploy verification until a telemetry connector exists | | [`source-driven-development`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/source-driven-development) | Detects versions, fetches the exact docs page, cites every framework choice, flags what it could not verify | Training data goes stale. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/source-driven-development/SKILL.md#L10)) | Grounding in live docs | **already have:** `plugins/discovery/skills/read-docs/SKILL.md:24`, `:48`, `plugins/context7/skills/lookup/SKILL.md:24`, `/discipline:do-your-research`, `docs/standards/source-authority-tiers.md:27-29` | | [`spec-driven-development`](https://github.com/addyosmani/agent-skills/tree/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development) | Capability map for bundled requests, a six-part spec, staged approvals, and a stop after writing | Building before requirements are written invites rework. **Stated** ([source](https://github.com/addyosmani/agent-skills/blob/39b723ceebf81474d0557c1fecd01eddab585563/skills/spec-driven-development/SKILL.md#L10)) | Locking intent and splitting a large effort | **already have:** `plugins/planning/skills/interview/SKILL.md:288`, `plugins/planning/skills/prd/SKILL.md:63`, `plugins/planning/skills/wayfind/SKILL.md:9`, `plugins/work-items/skills/decompose/SKILL.md:100-116` |