[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DH59CTYX82P7ZCECDMJD4X":3,"skill-same:01M7DH59CTYX82P7ZCECDMJD4X":59},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":48},"01M7DH59CTYX82P7ZCECDMJD4X","reconciling-documentation",null,"Sweeps a repository's documentation for claims that disagree with its code and tests, decides which side is wrong for each, and fixes it after approval. Use when the user asks to reconcile, audit, or fix documentation that has drifted from the code.","bostonaholic\u002Fskills","bostonaholic","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F362146?v=4","01M7DGVW4NA3AZAS7ZVN59FFTR","Matthew Boston","01M7DGVW56TS63D9MTAPRW8SCT",2,"MIT","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fincubating\u002Freconciling-documentation\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: reconciling-documentation\ndescription: Sweeps a repository's documentation for claims that disagree with its code and tests, decides which side is wrong for each, and fixes it after approval. Use when the user asks to reconcile, audit, or fix documentation that has drifted from the code.\ndisable-model-invocation: true\nmetadata:\n  internal: true\n---\n\n# Reconciling documentation\n\nTests check the code against what its authors meant. Nothing checks the code against what the docs say. This skill closes that gap for the scope the user names; with none named, the scope is the README, `AGENTS.md`, `CLAUDE.md`, and `docs\u002F`.\n\nEvery verdict follows the [docs and code rules](shared\u002Fdocs-vs-code.md).\n\n1. **List claims.** In each document in scope, record every claim a reader could check: a command, a path, a default, an option, a function's behavior. Skip opinions and plans. Keep each claim's `file:line`.\n2. **Check each claim** against the code and the tests. Record the code's `file:line` and the test that pins the behavior, or \"no test\". Run a documented command only when it is read-only.\n3. **Classify each mismatch** as a code bug, a stale doc, or unsettled. For an unsettled one, gather intent evidence before asking: callers that depend on one behavior, the history of both sides (`git log -L`, `git blame`), and any spec or issue. A side someone changed later on purpose usually states the intent.\n4. **Present the plan, then stop.** One row per mismatch: claim, doc line, code line, pinning test, verdict, planned fix. Ask the user to approve the plan and to settle each unsettled item. Change nothing before the answer.\n5. **Fix the approved rows.**\n   - Code bug: write a test that fails on the current code, run it to see it fail, change the code, and run it to see it pass.\n   - Stale doc: edit the document only; leave the code and tests as they are.\n6. **Verify.** Run the project's full test command once after the last fix. Report each row as fixed, skipped, or still open, with the test command's result.\n","# Reconciling documentation\n\nTests check the code against what its authors meant. Nothing checks the code against what the docs say. This skill closes that gap for the scope the user names; with none named, the scope is the README, `AGENTS.md`, `CLAUDE.md`, and `docs\u002F`.\n\nEvery verdict follows the [docs and code rules](shared\u002Fdocs-vs-code.md).\n\n1. **List claims.** In each document in scope, record every claim a reader could check: a command, a path, a default, an option, a function's behavior. Skip opinions and plans. Keep each claim's `file:line`.\n2. **Check each claim** against the code and the tests. Record the code's `file:line` and the test that pins the behavior, or \"no test\". Run a documented command only when it is read-only.\n3. **Classify each mismatch** as a code bug, a stale doc, or unsettled. For an unsettled one, gather intent evidence before asking: callers that depend on one behavior, the history of both sides (`git log -L`, `git blame`), and any spec or issue. A side someone changed later on purpose usually states the intent.\n4. **Present the plan, then stop.** One row per mismatch: claim, doc line, code line, pinning test, verdict, planned fix. Ask the user to approve the plan and to settle each unsettled item. Change nothing before the answer.\n5. **Fix the approved rows.**\n   - Code bug: write a test that fails on the current code, run it to see it fail, change the code, and run it to see it pass.\n   - Stale doc: edit the document only; leave the code and tests as they are.\n6. **Verify.** Run the project's full test command once after the last fix. Report each row as fixed, skipped, or still open, with the test command's result.\n",{"name":5,"metadata":24,"description":7,"disable-model-invocation":25},{"internal":25},true,"main","e8ff85fe8cec970c537bf34f0373fdff02834815","skills\u002Fincubating\u002Freconciling-documentation",0,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills","https:\u002F\u002Fskills.bostonaholic.dev","https:\u002F\u002Fgithub.com\u002Fbostonaholic","https:\u002F\u002Fmatthewboston.com","agility. simplicity. value.","2026-11-15 04:51:36",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":25},[38,41,44],{"tool":39,"command":40},"npx","npx skills add bostonaholic\u002Fskills --skill reconciling-documentation",{"tool":42,"command":43},"bunx","bunx skills add bostonaholic\u002Fskills --skill reconciling-documentation",{"tool":45,"command":46},"pnpm","pnpm dlx skills add bostonaholic\u002Fskills --skill reconciling-documentation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fincubating\u002Freconciling-documentation\u002FSKILL.md",[49,55],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"agents\u002Fopenai.yaml","REFERENCE","参考文档",260,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fincubating\u002Freconciling-documentation\u002Fagents\u002Fopenai.yaml",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"shared\u002Fdocs-vs-code.md",1328,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fincubating\u002Freconciling-documentation\u002Fshared\u002Fdocs-vs-code.md",[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7DH74HXXCFEZVAGZWETR4TY","writing-system-prompts","Writes and reviews system prompts for AI tools, agents, chatbots, and LLM products using a fixed section order and a quality checklist. Use when the user says \"write a system prompt\", or when drafting a system prompt or auditing one for missing stop criteria, tool rules, constraints, or examples. Not for compressing an existing prompt; use improving-prompts.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-system-prompts\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7DH6ZJ1RFRCGM01CGMJ10RY","writing-prose","Writes and edits prose for people in a plain, conversational, short house style with no em dashes. Use when the user says \"write this up\", or when drafting or revising documentation, READMEs, explanations, blog posts, or other human-facing prose. Not for prompts written for agents; use writing-system-prompts or composing-agent-prompts.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-prose\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7DH6TR43CYKY8VHFQWKNDWW","writing-acceptance-criteria","Writes or rewrites acceptance criteria until each is provable: one observable outcome with a named check that can fail. Use when the user says \"write acceptance criteria\", or asks to write, rewrite, or tighten acceptance criteria or a definition of done. Not for proving work meets them; use proving-claims.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-acceptance-criteria\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7DH6P0PC857A3W7CAGJPXSM","summarizing-shipped-work","Summarizes the user's merged GitHub PRs for a timeframe into a grouped, linked shipped-work report with highlights, and offers to update a brag document. Use when the user says \"what shipped?\", or when asked what the user shipped (this week, last month, a quarter, since a date), for a status update, or to update a brag doc.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fsummarizing-shipped-work\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7DH6H3YCJ59CZ0DMKHZ3N7S","running-retros","Mines a session transcript, past agent sessions, or named sources such as PR review comments for durable learnings, then proposes approval-gated edits to skills, AGENTS.md, or docs and tracker issues. Use when the user says \"retro\", or when the user explicitly asks for a retrospective. Never infer from session end or friction.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Frunning-retros\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7DH6C68WZB8Z6DD4MH770B7","learning-from-mistakes","Codifies the latest correction or mistake in the conversation as a short imperative rule in the project or global CLAUDE.md or AGENTS.md, after the user approves it. Use when the user says \"learn from this mistake\", or when the user asks to learn from a mistake, remember a lesson for next time, add a rule to CLAUDE.md, or not repeat a behavior. Not for a whole session; use running-retros.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Flearning-from-mistakes\u002FSKILL.md",[],[]]