[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78FQ43YA757CE75J1107H22":3,"skill-same:01M78FQ43YA757CE75J1107H22":50},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":43},"01M78FQ43YA757CE75J1107H22","retire-provisional-documents",null,"Retire provisional documentation after making its consumers self-contained and preserving only durable domain language and decision rationale.","fschwiet\u002Fhonist-v","fschwiet","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F222328?v=4","01M78FN2CHZJWBJQ7QGY7JDGBK","Frank","01M78FN2D6WBQQ07CV3R79V79M",0,"MIT","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fretire-provisional-documents\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: retire-provisional-documents\ndescription: Retire provisional documentation after making its consumers self-contained and preserving only durable domain language and decision rationale.\ndisable-model-invocation: true\n---\n\n# Retire Provisional Documents\n\nRetire every file under these repository-relative directories:\n\n- `docs\u002Fhonist-v\u002F`\n- `docs\u002Fmatt-pocock\u002F`\n\n## Verify a clean environment\n\nRefuse to continue if there are changes to tracked files in either the index or working tree.\n\n## Inventory the retirement set\n\n1. Enumerate every file currently beneath the two retirement directories, including untracked and hidden files. Sort the repository-relative paths and show the user the complete retirement set before reading or editing anything else: one path per line, with no summarized entries. This list is the retirement manifest.\n2. If any files in the retirement manifest are untracked warn the user and ask for their confirmation before proceeding.\n3. If the manifest is empty, report that there is nothing to retire and stop without committing.\n\nCompletion criterion: every file that this run could retire has appeared in the manifest, and the user can distinguish any untracked file whose deletion Git could not recover.\n\n## Load the durable context\n\nRead the complete [`domain-modeling` skill](..\u002Fmattpocock-skills\u002Fengineering\u002Fdomain-modeling\u002FSKILL.md), including the context and ADR formats it directs you to use. In the target repository, read `CONTEXT-MAP.md` when present, every repository `CONTEXT.md`, and every current ADR located by the domain-modeling rules.\n\nUse these sources to decide where durable information belongs. The provisional documents may reveal a claim or rationale to investigate, but they are not evidence that a current-state claim is true.\n\nCompletion criterion: the repository's complete domain vocabulary and current decision archive have been read before any replacement is proposed.\n\n## Remove dependencies on the manifest\n\nSearch every surviving repository file for references to the retirement directories or their files. Account for direct paths, relative links, directory-level links, and references identifiable only by a target filename. Inspect candidates rather than treating text-search matches as findings.\n\nClassify a reference by its purpose. A **maintenance reference** defines where or how provisional files are created, organized, found, read, or updated; the path is part of the surviving workflow rather than a dependency on the current contents. Preserve maintenance references when that workflow remains current, even when they name a retirement directory. For example, an issue-tracker guide may continue to define `docs\u002Fmatt-pocock\u002F` as its storage location. Treat a reference that expects information from a particular manifest file as a dependency to remove.\n\nFor every real reference, verify the information its consumer still needs against current code, configuration, tests, and surviving documentation. Propose the smallest change that lets the consumer stand on its own:\n\n- In code comments and code-facing documentation, retain only the non-obvious reason the code behaves as it does.\n- In user and agent documentation, retain common operational details that the reader needs there or that have no durable authoritative home. Point to an existing stable source when it already owns the detail and that stable source's location is unexpected.\n- Put canonical domain terms and boundaries in the applicable `CONTEXT.md`.\n- Put a design decision in an ADR only when it passes the domain-modeling skill's ADR test. Preserve the trade-off and rationale, not project chronology.\n- Remove a reference without replacement when its consumer needs none of the referenced information.\n\nFor each proposed change, record the surviving file affected, the reference being removed, the exact replacement or deletion, its authoritative evidence, and why that destination is appropriate. Every found reference must map to a proposed change or a documented no-change conclusion identifying a current maintenance reference.\n\nCompletion criterion: there is an evidence-backed disposition for every reference from a surviving file to a retirement path, and every retained reference is a current maintenance reference.\n\n## Agree on and commit the cleanup\n\nIf no surviving file depends on the manifest and every path reference is a current maintenance reference, tell the user this phase is a no-op. Create no empty commit and continue to the retirement phase.\n\nOtherwise, read and follow the complete [`grilling` skill](..\u002Fmattpocock-skills\u002Fproductivity\u002Fgrilling\u002FSKILL.md). Treat the proposed cleanup as its design tree. Explain the evidence and recommend a resolution for each change; investigate facts yourself and reserve questions for decisions. Editing begins only after the user confirms shared understanding for the complete cleanup set.\n\nApply exactly the approved set without modifying, renaming, or deleting any file in the retirement manifest. Re-run the reference search and relevant repository checks, then review the diff. Stage only the approved cleanup changes and commit them using the repository's commit conventions. Advance only when every surviving path reference is a verified maintenance reference; otherwise revise the proposal with the user.\n\nCompletion criterion: either the phase was a verified no-op, or a focused cleanup commit exists and every surviving reference to a retirement path is a current maintenance reference.\n\nOnly after meeting that criterion, review every file in the retirement manifest in the context of the complete manifest, the repository's `CONTEXT.md` files, its current ADRs, and the `domain-modeling` skill.\n\n## Review what deserves a durable home\n\nAccount for every manifest file and classify its useful information:\n\n- Propose canonical terms and domain boundaries for the applicable `CONTEXT.md`. Keep that file a glossary without implementation details.\n- Propose a new or updated ADR only for a decision that passes the domain-modeling skill's ADR test. Preserve why the current decision was made: the alternatives, trade-off, and constraints that still explain it.\n- Discard status reports, implementation narration, superseded plans, chronology, and descriptions of current behavior that the repository itself makes discoverable.\n- Avoid duplicating information already owned by a surviving authoritative source.\n\nFor every proposed ADR creation or update, inspect the code and surviving documentation that bear on its claims. Reconcile contradictions before proposing text. For every proposed `CONTEXT.md` change, verify that the terminology describes the current domain consistently.\n\nBuild a proposed retirement set that names, for every manifest file, the exact information to migrate and its destination or states that nothing in the file merits preservation. Include the complete deletion manifest.\n\nCompletion criterion: every file to be deleted has been reviewed, every preservation proposal has current evidence and one durable home, and the deletion manifest matches the target directories' current contents.\n\n## Agree on the retirement\n\nRead and follow the complete `grilling` skill again. Start a new design tree covering every proposed `CONTEXT.md` or ADR change and deletion of the exact manifest. Group independent decisions into the same frontier round, show the evidence for each proposal, and give a recommended resolution.\n\nUpdate the proposal as answers reshape it. Do not edit or delete files until the user confirms shared understanding for all durable-context changes and the complete deletion manifest.\n\nCompletion criterion: the user has approved an exact change set and every file slated for deletion has appeared in that approval.\n\n## Apply and commit the retirement\n\nApply exactly the approved `CONTEXT.md` and ADR changes, then delete every file in the approved manifest. Do not delete similarly named directories or files outside it.\n\nVerify that:\n\n- each changed or created ADR follows the domain-modeling format and agrees with current code and surviving documentation;\n- each changed `CONTEXT.md` follows the domain-modeling format and contains domain language rather than implementation detail;\n- no surviving reference depends on a retired manifest file, and every retained retirement-path reference is a current maintenance reference;\n- the two retirement directories contain no files; and\n- the diff contains only approved durable-context changes and manifest deletions.\n\nRun relevant repository checks. Stage only the approved changes and deletions, then create one coherent retirement commit using the repository's commit conventions. If the approved set contains no durable-context changes, create the deletion-only commit. Report any deleted untracked files separately because they cannot appear in the commit.\n\nCompletion criterion: every approved manifest file is absent, the relevant checks pass, and the retirement commit contains no unrelated changes.\n","# Retire Provisional Documents\n\nRetire every file under these repository-relative directories:\n\n- `docs\u002Fhonist-v\u002F`\n- `docs\u002Fmatt-pocock\u002F`\n\n## Verify a clean environment\n\nRefuse to continue if there are changes to tracked files in either the index or working tree.\n\n## Inventory the retirement set\n\n1. Enumerate every file currently beneath the two retirement directories, including untracked and hidden files. Sort the repository-relative paths and show the user the complete retirement set before reading or editing anything else: one path per line, with no summarized entries. This list is the retirement manifest.\n2. If any files in the retirement manifest are untracked warn the user and ask for their confirmation before proceeding.\n3. If the manifest is empty, report that there is nothing to retire and stop without committing.\n\nCompletion criterion: every file that this run could retire has appeared in the manifest, and the user can distinguish any untracked file whose deletion Git could not recover.\n\n## Load the durable context\n\nRead the complete [`domain-modeling` skill](..\u002Fmattpocock-skills\u002Fengineering\u002Fdomain-modeling\u002FSKILL.md), including the context and ADR formats it directs you to use. In the target repository, read `CONTEXT-MAP.md` when present, every repository `CONTEXT.md`, and every current ADR located by the domain-modeling rules.\n\nUse these sources to decide where durable information belongs. The provisional documents may reveal a claim or rationale to investigate, but they are not evidence that a current-state claim is true.\n\nCompletion criterion: the repository's complete domain vocabulary and current decision archive have been read before any replacement is proposed.\n\n## Remove dependencies on the manifest\n\nSearch every surviving repository file for references to the retirement directories or their files. Account for direct paths, relative links, directory-level links, and references identifiable only by a target filename. Inspect candidates rather than treating text-search matches as findings.\n\nClassify a reference by its purpose. A **maintenance reference** defines where or how provisional files are created, organized, found, read, or updated; the path is part of the surviving workflow rather than a dependency on the current contents. Preserve maintenance references when that workflow remains current, even when they name a retirement directory. For example, an issue-tracker guide may continue to define `docs\u002Fmatt-pocock\u002F` as its storage location. Treat a reference that expects information from a particular manifest file as a dependency to remove.\n\nFor every real reference, verify the information its consumer still needs against current code, configuration, tests, and surviving documentation. Propose the smallest change that lets the consumer stand on its own:\n\n- In code comments and code-facing documentation, retain only the non-obvious reason the code behaves as it does.\n- In user and agent documentation, retain common operational details that the reader needs there or that have no durable authoritative home. Point to an existing stable source when it already owns the detail and that stable source's location is unexpected.\n- Put canonical domain terms and boundaries in the applicable `CONTEXT.md`.\n- Put a design decision in an ADR only when it passes the domain-modeling skill's ADR test. Preserve the trade-off and rationale, not project chronology.\n- Remove a reference without replacement when its consumer needs none of the referenced information.\n\nFor each proposed change, record the surviving file affected, the reference being removed, the exact replacement or deletion, its authoritative evidence, and why that destination is appropriate. Every found reference must map to a proposed change or a documented no-change conclusion identifying a current maintenance reference.\n\nCompletion criterion: there is an evidence-backed disposition for every reference from a surviving file to a retirement path, and every retained reference is a current maintenance reference.\n\n## Agree on and commit the cleanup\n\nIf no surviving file depends on the manifest and every path reference is a current maintenance reference, tell the user this phase is a no-op. Create no empty commit and continue to the retirement phase.\n\nOtherwise, read and follow the complete [`grilling` skill](..\u002Fmattpocock-skills\u002Fproductivity\u002Fgrilling\u002FSKILL.md). Treat the proposed cleanup as its design tree. Explain the evidence and recommend a resolution for each change; investigate facts yourself and reserve questions for decisions. Editing begins only after the user confirms shared understanding for the complete cleanup set.\n\nApply exactly the approved set without modifying, renaming, or deleting any file in the retirement manifest. Re-run the reference search and relevant repository checks, then review the diff. Stage only the approved cleanup changes and commit them using the repository's commit conventions. Advance only when every surviving path reference is a verified maintenance reference; otherwise revise the proposal with the user.\n\nCompletion criterion: either the phase was a verified no-op, or a focused cleanup commit exists and every surviving reference to a retirement path is a current maintenance reference.\n\nOnly after meeting that criterion, review every file in the retirement manifest in the context of the complete manifest, the repository's `CONTEXT.md` files, its current ADRs, and the `domain-modeling` skill.\n\n## Review what deserves a durable home\n\nAccount for every manifest file and classify its useful information:\n\n- Propose canonical terms and domain boundaries for the applicable `CONTEXT.md`. Keep that file a glossary without implementation details.\n- Propose a new or updated ADR only for a decision that passes the domain-modeling skill's ADR test. Preserve why the current decision was made: the alternatives, trade-off, and constraints that still explain it.\n- Discard status reports, implementation narration, superseded plans, chronology, and descriptions of current behavior that the repository itself makes discoverable.\n- Avoid duplicating information already owned by a surviving authoritative source.\n\nFor every proposed ADR creation or update, inspect the code and surviving documentation that bear on its claims. Reconcile contradictions before proposing text. For every proposed `CONTEXT.md` change, verify that the terminology describes the current domain consistently.\n\nBuild a proposed retirement set that names, for every manifest file, the exact information to migrate and its destination or states that nothing in the file merits preservation. Include the complete deletion manifest.\n\nCompletion criterion: every file to be deleted has been reviewed, every preservation proposal has current evidence and one durable home, and the deletion manifest matches the target directories' current contents.\n\n## Agree on the retirement\n\nRead and follow the complete `grilling` skill again. Start a new design tree covering every proposed `CONTEXT.md` or ADR change and deletion of the exact manifest. Group independent decisions into the same frontier round, show the evidence for each proposal, and give a recommended resolution.\n\nUpdate the proposal as answers reshape it. Do not edit or delete files until the user confirms shared understanding for all durable-context changes and the complete deletion manifest.\n\nCompletion criterion: the user has approved an exact change set and every file slated for deletion has appeared in that approval.\n\n## Apply and commit the retirement\n\nApply exactly the approved `CONTEXT.md` and ADR changes, then delete every file in the approved manifest. Do not delete similarly named directories or files outside it.\n\nVerify that:\n\n- each changed or created ADR follows the domain-modeling format and agrees with current code and surviving documentation;\n- each changed `CONTEXT.md` follows the domain-modeling format and contains domain language rather than implementation detail;\n- no surviving reference depends on a retired manifest file, and every retained retirement-path reference is a current maintenance reference;\n- the two retirement directories contain no files; and\n- the diff contains only approved durable-context changes and manifest deletions.\n\nRun relevant repository checks. Stage only the approved changes and deletions, then create one coherent retirement commit using the repository's commit conventions. If the approved set contains no durable-context changes, create the deletion-only commit. Report any deleted untracked files separately because they cannot appear in the commit.\n\nCompletion criterion: every approved manifest file is absent, the relevant checks pass, and the retirement commit contains no unrelated changes.\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","e8a43a7014c4bfc30a1e51cf05a81fbece745669","plugin\u002Fskills\u002Fretire-provisional-documents","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v","https:\u002F\u002Fgithub.com\u002Ffschwiet","2026-11-08 03:21:07",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":24},[33,36,39],{"tool":34,"command":35},"npx","npx skills add fschwiet\u002Fhonist-v --skill retire-provisional-documents",{"tool":37,"command":38},"bunx","bunx skills add fschwiet\u002Fhonist-v --skill retire-provisional-documents",{"tool":40,"command":41},"pnpm","pnpm dlx skills add fschwiet\u002Fhonist-v --skill retire-provisional-documents","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fretire-provisional-documents\u002FSKILL.md",[44],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"agents\u002Fopenai.yaml","REFERENCE","参考文档",289,"https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fretire-provisional-documents\u002Fagents\u002Fopenai.yaml",[51,58,65,72,79,86],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M78FQ9X3171KQYNFT89TKKYV","sync-skills-openai-yaml","Sync every skill's agents\u002Fopenai.yaml with its SKILL.md — display name, short description, and implicit-invocation policy.","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fsync-skills-openai-yaml\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M78FQ6N0F9AC5TE2H1P5SX8E","streamlined-setup-matt-pocock-skills","Configure this repo for the engineering skills using one fixed set of choices: local-markdown issue tracker, default triage labels, single-context domain docs. Overwrites any earlier setup. Run once per repo.","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fstreamlined-setup-matt-pocock-skills\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M78FQ1TBFXGS929WWHC9G93P","coding-agent-sessions","Find, read, list, search, inspect, fetch, export, or reconstruct coding-agent sessions across various agents.","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Foh-my-openagent\u002Fcoding-agent-sessions\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M78FQ01AK703N37Q2AMTG6NP","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fmattpocock-skills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M78FPYN3J3S3J05XZ2VWJ629","wait-what","Stop. That last message did not land: re-pitch it.","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fmattpocock-skills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M78FPX1DR4YFT1TJWS13SF5C","to-questionnaire","Turn a decision you can't fully answer into a questionnaire for someone else to fill in.","https:\u002F\u002Fgithub.com\u002Ffschwiet\u002Fhonist-v\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fmattpocock-skills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[]]