[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EG1H4K07BAM3WZ5CCSWVA0":3,"skill-same:01M7EG1H4K07BAM3WZ5CCSWVA0":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":42},"01M7EG1H4K07BAM3WZ5CCSWVA0","verify-doc-check",null,"Monthly check that this repo's docs\u002Fagents\u002Fverify.md still starts the stack: read every claim against the source, run the recipe in a fresh worktree, fix or file each drifted step.","kaminski-dev\u002Fdk-agent-kit","kaminski-dev","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F39885406?v=4","01M7EFZ8VTE8FQS6R0G2Y6RB55","01M7EFZ8WESD6VKM8G7BQYAYWX",0,"MIT","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Fverify-doc-check\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: verify-doc-check\ndescription: \"Monthly check that this repo's docs\u002Fagents\u002Fverify.md still starts the stack: read every claim against the source, run the recipe in a fresh worktree, fix or file each drifted step.\"\ndisable-model-invocation: true\n---\n\n\u003C!-- Adapted from cursor\u002Fplugins pstack@ae5650f skills\u002Fmaintain-verification-skill, MIT (© 2026 Lauren Tan). Changed for dk-agent-kit: the target is docs\u002Fagents\u002Fverify.md run under the dk:verify protocol, readers per doc section, drift fixed in a PR into pre-main or filed as a needs-triage issue. -->\n\n# Verify doc check\n\nA verify doc rots the moment the stack changes: a renamed env var, a moved script, a port that is no longer free. This check runs the repo's `docs\u002Fagents\u002Fverify.md` the way the next `dk:verify` run will, from the doc alone, and turns each step that fails into a fix or an issue. One run covers one repo.\n\n**From the doc alone** means: the doc, the fresh-worktree setup in `docs\u002Fagents\u002Fworkflow.md`, and the `dk:verify` protocol. Every other fact you needed to get a step through (a README line, a file from the main checkout, a memory, a guess that worked) is **drift**: a fact the doc owes.\n\n`$RUN` is `$SCRATCH\u002Fverify-doc\u002F\u003Crepo>\u002F`. Wherever the doc writes `\u003CN>`, use the key `verify-doc`.\n\n## Outcome\n\nName one in the report:\n\n- **clean**: every section read against the source and every step run; nothing drifted.\n- **changed**: drift found; each instance fixed in the PR or filed as an issue.\n- **blocked**: a step could not run for a reason outside the doc (Docker down, no network, a login only the maintainer holds). Name the step and the reason.\n\n## Edit scope\n\nA fix touches only the doc and the harness it names (its scripts, stubs, helpers). Each failing step is one of three kinds:\n\n- **Doc drift**: the doc says something the repo no longer does or lacks a fact the run needed. Fix the doc.\n- **Harness gap**: the repo works, but a script the doc names cannot drive it. Fix the script.\n- **Product gap**: the app itself is broken. File it as an issue; the doc keeps describing correct behaviour.\n\n## 1. Fresh worktree\n\n```sh\ngit fetch -q origin\nbase=origin\u002Fpre-main\ngit ls-remote --exit-code --heads origin pre-main >\u002Fdev\u002Fnull || base=origin\u002Fmain\ngit worktree add --detach \"$RUN\u002Ftree\" \"$base\"\n```\n\nA base of `origin\u002Fmain` means the remote has no `pre-main`; say so in the report. Run the fresh-worktree setup from `workflow.md` in it. No `docs\u002Fagents\u002Fverify.md` there: stop and point at `\u002Fdk:setup`.\n\nStart `$RUN\u002Frun.md`, the **run log**: one line per doc step with the command as run, the result, and its kind when it failed. It stays in `$RUN`, never in the tree.\n\nDone when `$RUN\u002Ftree` is checked out at the base you name in the report, the fresh-worktree setup exited zero there, and `$RUN\u002Frun.md` exists.\n\n## 2. Source wave\n\nSplit the doc by its sections (stack start, database, stubs, seeding, login, endpoints, browser, and any others it has). Launch one read-only `dk:codebase-analyzer` per section, all in one message. Each gets the section's text and the worktree path, checks every claim it makes against the source (each script and path exists, each env var is read under that name, each port, route, seeded user and migration tool matches), and returns: claims confirmed, likely drift with `file:line`, and the one live step that exercises the section.\n\nDone when every section has a returned list. Spot-check each cited drift yourself before it counts.\n\n## 3. Live pass\n\nRun the doc's recipe in its own order, exactly as written, under `dk:verify` steps 2 and 3 (ports checked before each start, every process and port noted). Exercise every section at least once:\n\n- the stack starts and its health or ready endpoint answers;\n- the database migrates, and the Down half runs down and up again;\n- each stub the doc names starts, or its absence shows the log line the doc quotes;\n- seeding runs on the migrated database;\n- the login yields a read and a write that succeed;\n- one route under each endpoint prefix answers;\n- the frontend loads at 1280 px and at 390 × 844 and the seeded user logs in.\n\nA step that fails: log it with its output, find the variant that works, log that too, and go on with the variant so the later steps still run. A step you cannot reach is **unreachable** only with the prerequisite it needs and the route you tried. The live pass is required even when the source wave came back clean.\n\nDone when every step has a line in the run log.\n\n## 4. Tear down\n\n`dk:verify` step 7, then `git worktree remove \"$RUN\u002Ftree\"`. Done when none of your ports listens, `dk-pg status verify-doc` prints `none running`, and the worktree is gone.\n\n## 5. Fix or file\n\n- **Doc drift and harness gaps**: one PR through `dk:issue-flow` (one issue for the run, its branch off `pre-main`), carrying each fix. Run every fixed step again in a fresh worktree of the branch before opening it; the PR's Evidence is the failing run-log line beside the passing one.\n- **Product gaps**, and drift you cannot prove a fix for: one issue each, labelled `needs-triage`, opening with `Found by the verify doc check` and the run-log lines. Search open issues first (`dk:issue-flow` step 3) and comment on a match instead.\n\nDone when every failed line in the run log names the PR that fixes it or the issue (new or commented) that records it.\n\nReport the outcome, the run-log path, and the PR and issues.\n","\u003C!-- Adapted from cursor\u002Fplugins pstack@ae5650f skills\u002Fmaintain-verification-skill, MIT (© 2026 Lauren Tan). Changed for dk-agent-kit: the target is docs\u002Fagents\u002Fverify.md run under the dk:verify protocol, readers per doc section, drift fixed in a PR into pre-main or filed as a needs-triage issue. -->\n\n# Verify doc check\n\nA verify doc rots the moment the stack changes: a renamed env var, a moved script, a port that is no longer free. This check runs the repo's `docs\u002Fagents\u002Fverify.md` the way the next `dk:verify` run will, from the doc alone, and turns each step that fails into a fix or an issue. One run covers one repo.\n\n**From the doc alone** means: the doc, the fresh-worktree setup in `docs\u002Fagents\u002Fworkflow.md`, and the `dk:verify` protocol. Every other fact you needed to get a step through (a README line, a file from the main checkout, a memory, a guess that worked) is **drift**: a fact the doc owes.\n\n`$RUN` is `$SCRATCH\u002Fverify-doc\u002F\u003Crepo>\u002F`. Wherever the doc writes `\u003CN>`, use the key `verify-doc`.\n\n## Outcome\n\nName one in the report:\n\n- **clean**: every section read against the source and every step run; nothing drifted.\n- **changed**: drift found; each instance fixed in the PR or filed as an issue.\n- **blocked**: a step could not run for a reason outside the doc (Docker down, no network, a login only the maintainer holds). Name the step and the reason.\n\n## Edit scope\n\nA fix touches only the doc and the harness it names (its scripts, stubs, helpers). Each failing step is one of three kinds:\n\n- **Doc drift**: the doc says something the repo no longer does or lacks a fact the run needed. Fix the doc.\n- **Harness gap**: the repo works, but a script the doc names cannot drive it. Fix the script.\n- **Product gap**: the app itself is broken. File it as an issue; the doc keeps describing correct behaviour.\n\n## 1. Fresh worktree\n\n```sh\ngit fetch -q origin\nbase=origin\u002Fpre-main\ngit ls-remote --exit-code --heads origin pre-main >\u002Fdev\u002Fnull || base=origin\u002Fmain\ngit worktree add --detach \"$RUN\u002Ftree\" \"$base\"\n```\n\nA base of `origin\u002Fmain` means the remote has no `pre-main`; say so in the report. Run the fresh-worktree setup from `workflow.md` in it. No `docs\u002Fagents\u002Fverify.md` there: stop and point at `\u002Fdk:setup`.\n\nStart `$RUN\u002Frun.md`, the **run log**: one line per doc step with the command as run, the result, and its kind when it failed. It stays in `$RUN`, never in the tree.\n\nDone when `$RUN\u002Ftree` is checked out at the base you name in the report, the fresh-worktree setup exited zero there, and `$RUN\u002Frun.md` exists.\n\n## 2. Source wave\n\nSplit the doc by its sections (stack start, database, stubs, seeding, login, endpoints, browser, and any others it has). Launch one read-only `dk:codebase-analyzer` per section, all in one message. Each gets the section's text and the worktree path, checks every claim it makes against the source (each script and path exists, each env var is read under that name, each port, route, seeded user and migration tool matches), and returns: claims confirmed, likely drift with `file:line`, and the one live step that exercises the section.\n\nDone when every section has a returned list. Spot-check each cited drift yourself before it counts.\n\n## 3. Live pass\n\nRun the doc's recipe in its own order, exactly as written, under `dk:verify` steps 2 and 3 (ports checked before each start, every process and port noted). Exercise every section at least once:\n\n- the stack starts and its health or ready endpoint answers;\n- the database migrates, and the Down half runs down and up again;\n- each stub the doc names starts, or its absence shows the log line the doc quotes;\n- seeding runs on the migrated database;\n- the login yields a read and a write that succeed;\n- one route under each endpoint prefix answers;\n- the frontend loads at 1280 px and at 390 × 844 and the seeded user logs in.\n\nA step that fails: log it with its output, find the variant that works, log that too, and go on with the variant so the later steps still run. A step you cannot reach is **unreachable** only with the prerequisite it needs and the route you tried. The live pass is required even when the source wave came back clean.\n\nDone when every step has a line in the run log.\n\n## 4. Tear down\n\n`dk:verify` step 7, then `git worktree remove \"$RUN\u002Ftree\"`. Done when none of your ports listens, `dk-pg status verify-doc` prints `none running`, and the worktree is gone.\n\n## 5. Fix or file\n\n- **Doc drift and harness gaps**: one PR through `dk:issue-flow` (one issue for the run, its branch off `pre-main`), carrying each fix. Run every fixed step again in a fresh worktree of the branch before opening it; the PR's Evidence is the failing run-log line beside the passing one.\n- **Product gaps**, and drift you cannot prove a fix for: one issue each, labelled `needs-triage`, opening with `Found by the verify doc check` and the run-log lines. Search open issues first (`dk:issue-flow` step 3) and comment on a match instead.\n\nDone when every failed line in the run log names the PR that fixes it or the issue (new or commented) that records it.\n\nReport the outcome, the run-log path, and the PR and issues.\n",{"name":5,"description":7,"disable-model-invocation":23},true,"main","53eb522da63c98ceb28f1af6a9d88cb3711b2097","plugins\u002Fdk\u002Fskills\u002Fverify-doc-check","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit","https:\u002F\u002Fgithub.com\u002Fkaminski-dev","2026-11-05 04:08:01",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":23},[32,35,38],{"tool":33,"command":34},"npx","npx skills add kaminski-dev\u002Fdk-agent-kit --skill verify-doc-check",{"tool":36,"command":37},"bunx","bunx skills add kaminski-dev\u002Fdk-agent-kit --skill verify-doc-check",{"tool":39,"command":40},"pnpm","pnpm dlx skills add kaminski-dev\u002Fdk-agent-kit --skill verify-doc-check","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Fverify-doc-check\u002FSKILL.md",[],[44,51,58,65,72,79],{"skillNo":45,"name":46,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":18},"01M7EG1RARBVATTAE5WVX76WS5","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M7EG1MXJHKQPYRD5ZR3HH4F8","verify","Prove a change works by driving it in a stack you started, against a control run of the pre-fix state. Use before calling any change verified, or when asked to verify or prove a fix.","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Fverify\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M7EG1EWNF1SSMAJZDD5F6BWZ","triage","Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Ftriage\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M7EG1AQAXT5E40W5YRZDHBH6","to-tickets","Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, published to the configured tracker (edges as text in one file per ticket locally, or native blocking links on a real tracker).","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Fto-tickets\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M7EG18P4M7YT88WHJA7M5N6F","to-spec","Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Fto-spec\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EG16VQWNY9VV1YTDRPFJXN","teach","Teach the user a new skill or concept, within this workspace.","https:\u002F\u002Fgithub.com\u002Fkaminski-dev\u002Fdk-agent-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fdk\u002Fskills\u002Fteach\u002FSKILL.md",[],[]]