[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FNDRF5JP4TK1WFFTWSWSM":3,"skill-same:01M74FNDRF5JP4TK1WFFTWSWSM":75},{"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":36,"commitSha":37,"skillDirectory":38,"forksCount":39,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":42,"ownerDescription":43,"updatedAt":44,"install":45,"resources":58},"01M74FNDRF5JP4TK1WFFTWSWSM","write-contributing",null,"Writes and maintains a repo's `CONTRIBUTING.md` in the house style — scaffolds one where none exists, reconciles an existing guide against the repo it describes. Every repo-specific statement is derived from the file that owns it (branch base from `pr.base`, the gate command from the root `verify` key, the commit convention from commitlint, intake links from `.github\u002FISSUE_TEMPLATE\u002F`, the package manager from the lockfile) instead of retyped, so the guide cannot contradict the repo; hand-written prose is never rewritten. Previews a plan and writes only after confirmation. Use when the user wants to write, scaffold, fix, update or reconcile a contributing guide or `CONTRIBUTING.md`, says the guide is out of date or tells contributors the wrong branch, or says things like \"write the contributing guide\", \"update CONTRIBUTING.md\", \"Contributing-Guide schreiben\", \"CONTRIBUTING aktualisieren\". Not for READMEs or the `docs\u002F` tree.","TitusKirch\u002Fskills","TitusKirch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F16943133?v=4","01M74FN1AAM5K2NH5EG292B2HZ","Titus Kirch","01M74FN1AX7TX6RAECBHE5PMNT",3,"MIT","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fwrite-contributing\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: write-contributing\nmetadata:\n  summary: Writes and reconciles CONTRIBUTING.md in the house style, deriving every repo fact from the file that owns it.\ndescription: Writes and maintains a repo's `CONTRIBUTING.md` in the house style — scaffolds one where none exists, reconciles an existing guide against the repo it describes. Every repo-specific statement is derived from the file that owns it (branch base from `pr.base`, the gate command from the root `verify` key, the commit convention from commitlint, intake links from `.github\u002FISSUE_TEMPLATE\u002F`, the package manager from the lockfile) instead of retyped, so the guide cannot contradict the repo; hand-written prose is never rewritten. Previews a plan and writes only after confirmation. Use when the user wants to write, scaffold, fix, update or reconcile a contributing guide or `CONTRIBUTING.md`, says the guide is out of date or tells contributors the wrong branch, or says things like \"write the contributing guide\", \"update CONTRIBUTING.md\", \"Contributing-Guide schreiben\", \"CONTRIBUTING aktualisieren\". Not for READMEs or the `docs\u002F` tree.\nallowed-tools:\n  - Read\n  - Write\n  - Edit\n  - Glob\n  - Grep\n  - Bash(jq:*)\n  - Bash(grep:*)\n  - Bash(git symbolic-ref:*)\n  - Bash(gh repo view:*)\n---\n\n# write-contributing\n\n`CONTRIBUTING.md` is the one document that tells a contributor **how work is done in this repo** — which branch to start from, which command has to pass, how a commit is worded, where a bug goes. This skill owns that convention: one house structure, the same in every repo, with the repo-specific values read out of the repo rather than typed in. Structure catalogue, derivation recipes and reconcile rules: [REFERENCE.md](REFERENCE.md). Skeleton to copy: [`templates\u002FCONTRIBUTING.template.md`](templates\u002FCONTRIBUTING.template.md).\n\nIt is the guide's generator **and** its linter — the same skill scaffolds a missing one and reconciles an existing one, because the failure this exists to prevent is not a missing guide but a stale one.\n\n## Derived, not retyped\n\nAlmost nothing in a contributing guide is the guide's own fact. Split every statement in two, and the whole skill follows:\n\n| Kind         | What it is                                                                                                                       | This skill                                                     |\n| :----------- | :------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------- |\n| **Derived**  | A fact some **other file** decides — the branch base, the gate command, the commit convention, the runtime floor, an intake link | **owns it**: reads the owner every run and writes what it says |\n| **Authored** | The project's own prose — what a good PR looks like, the review bar, what this project is picky about                            | **never rewrites it**; may report it as suspect                |\n\nA derived statement is **re-derived on every run**, never carried over from the existing text and never copied from another repo's guide. That is the entire mechanism: a guide assembled from the files it describes cannot contradict them, and a guide reconciled against them stops being able to drift silently.\n\n**A fact with no owning file is asked about, never assumed.** \"The default branch is `main`\" is exactly the assumption that puts a contributor on the wrong branch — and it is the shape of every derivation failure here. Where two candidate owners disagree, that is a **prompt**, not a judgement call ([reconcile](#reconcile--the-guide-exists)).\n\nWhat each statement is derived **from** is the derivation table in [REFERENCE.md](REFERENCE.md#derivation-table) — one row per fact, with its owning file, its fallback chain, and what must never stand in for it.\n\n## Jobs — pick by repo state + intent\n\n| State \u002F intent                                                 | Job           |\n| :------------------------------------------------------------- | :------------ |\n| No `CONTRIBUTING.md`                                           | **scaffold**  |\n| It exists + \"update \u002F fix \u002F align \u002F reconcile it\"              | **reconcile** |\n| It exists + \"document X in it\" (a new contributor-facing step) | **add**       |\n\nOptional command shortcuts in clients that expose them: `write-contributing init`, `write-contributing add \u003Cstep>`, `write-contributing reconcile`. Otherwise infer from repo state and the request. **Always: plan → confirm → apply.**\n\n**Plan-only triggers** — \"just show me\", \"dry run\", \"plan only\", \"nur den Plan\", \"nicht schreiben\": print the plan and the derivation table, write nothing.\n\n## Structure — the house order\n\n| #   | Section               | Include when                                                             | Holds                                                                                |\n| :-- | :-------------------- | :----------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |\n| 1   | Title + intro         | Always                                                                   | One welcoming line; the only place an emoji is allowed                               |\n| 2   | Code of Conduct       | `CODE_OF_CONDUCT.md` exists                                              | Two sentences and the link — never a summary of it                                   |\n| 3   | Reporting issues      | Always                                                                   | One line per intake route, each a link ([derivation](REFERENCE.md#derivation-table)) |\n| 4   | Development setup     | Always                                                                   | Runtime floor, package manager, clone + install                                      |\n| 5   | Adding a new `\u003Cunit>` | The repo has a repeatable contribution unit (a skill, a package, a rule) | The numbered path from empty folder to commit                                        |\n| 6   | Running the suite     | Always                                                                   | The gate first, then the few commands a contributor runs by hand                     |\n| 7   | Branching & PRs       | Always                                                                   | The **base branch**, the commit convention, one concern per PR                       |\n| 8   | Style & quality gates | Hooks or a formatter are configured                                      | What runs on commit, and what to do when it fails                                    |\n| 9   | Releases              | Release automation exists                                                | Two sentences: what cuts a release, from where                                       |\n| 10  | License               | Always                                                                   | The inbound=outbound sentence and the link                                           |\n\n**A section whose signal is absent is left out, not written empty.** \"This project has no release process\" is a line that tells a contributor nothing and goes stale the day one appears.\n\n### Style rules\n\n- **Emoji in the intro line only** — never in a heading. A contributing guide is not the README; the section emojis `write-readme` prescribes stop at the README's front door.\n- **Second person, imperative, short.** The reader is mid-task.\n- **Callouts** use `> [!TIP]` \u002F `> [!IMPORTANT]` \u002F `> [!NOTE]`, never a plain blockquote.\n- **Tables** are left-aligned (`| :--- |`).\n- **Never transcribe a file — any file, any list.** The rule is about **every enumeration**, not one table: a list whose owner is another file is **linked, not copied**, whatever it enumerates — the manifest's scripts, the artifacts a sync or codegen command writes, a unit's frontmatter fields, the globs a hook matches. The suite table is only its most familiar case: it names the gate and the handful of commands a contributor types, not every script in the manifest. **And where such a list must appear, it appears without a count in front of it** — \"regenerates the four artifacts\" is the one claim no gate can check, and it goes stale the day a fifth is added while every item beside it still reads true. Link the owner and let the owner say how many; a transcribed list is the second-most-common stale block in any guide, after the branch name.\n- **Repo files are linked relatively** (`CODE_OF_CONDUCT.md`, `SECURITY.md`, `LICENSE`), forge routes absolutely (a `?template=` new-issue URL). A relative link is what survives a fork.\n\n## Scaffold — no guide yet\n\n1. **Resolve the config** — `pr.base`, root `verify`, root `language` ([REFERENCE.md](REFERENCE.md#config)).\n2. **Derive every fact** in the [derivation table](REFERENCE.md#derivation-table). Anything with no owner and no answer: **ask**.\n3. **Pick the sections** — the structure above, dropping each whose signal the repo does not show, and naming the drops in the plan.\n4. **Show the plan**: the section list, plus the derived facts as `fact → value → the file it came from`. That table is the part a human can actually check; the prose is the part they cannot.\n5. **On confirm** — fill [`templates\u002FCONTRIBUTING.template.md`](templates\u002FCONTRIBUTING.template.md) and write `CONTRIBUTING.md`.\n\n## Add — the guide exists, document one more step\n\nA human asks for a contributor-facing step the guide has never carried: a one-time setup command the install does not do, a second intake route, the path for adding a new unit. **Distinct from the reconcile pass's [Add](#reconcile--the-guide-exists) bullet** — that one is a _derived_ span whose owner already exists and the guide merely never mentioned, found by the pass itself; this one is a request, and its content may have no owning file at all.\n\n1. **Place it by the catalogue, not by the request's wording.** The step belongs in whichever [structure](#structure--the-house-order) row it matches. A step matching **no** row gets a section of its own, at the position the [catalogue](REFERENCE.md#section-catalogue) suggests, and the plan says so rather than deciding quietly.\n2. **The right section may not exist yet.** A repo that has just grown a release flow carries no Releases section. Then this job **creates that one section**, in house order — and no other.\n3. **Derive whatever the new text states.** The [derivation table](REFERENCE.md#derivation-table) binds here exactly as in a scaffold: a step that names a branch, a command or a file reads it from the owning file, never from how the request phrased it. A fact with no owner is **asked about**, not assumed.\n4. **Everything around it stays byte-identical.** Authored prose in the same section is untouched, and no other section is re-derived — re-deriving the whole guide is the **reconcile** job, and the user asked for this step. Drift noticed in passing is **named in the report**, never fixed here; offer the reconcile pass instead.\n5. **Plan → confirm → apply** — show the placement, the derived values with their sources, and the diff.\n\n## Reconcile — the guide exists\n\nDesired-state and idempotent — a `--fix` linter over one file. Running it twice changes nothing the second time.\n\n1. **Read the whole guide fresh**, then every owning file it makes a claim about. Both are live state; neither is cached.\n2. **Classify each span** derived or authored, then group the plan into four:\n   - **Rewrite** — derived, and it contradicts its owner. The owner wins, always: the repo is right and the guide follows. (`Branch off main` where `pr.base` is `dev`.)\n   - **Add** — derived and missing. The repo grew a gate, an intake template, a hook the guide never mentions.\n   - **Prompt** — derived and ambiguous. Two owners disagree — `engines` says one runtime, the CI matrix another — so the run **asks** instead of picking.\n   - **Report only** — authored prose that reads stale, a section fitting nothing, a dead link, a detected secret. Named in the report, **never auto-edited**.\n3. **Show the plan and the diff**; on confirm, apply. **Never rewrite authored prose. Only touch `CONTRIBUTING.md`.**\n\n**A derived span whose owner is gone** — a command no longer in the manifest, a workflow deleted — is a **removal**, confirmed span by span and never in bulk: an owner that vanished is as often a rename as a deletion.\n\n\u003Cskills-plan>\n\n## Presenting the plan\n\nEverything this skill puts in front of a human — plan, preview, candidate list, findings report —\nis read **once, in a terminal**, and answered there. So **every section of it renders on arrival**,\nwith no interaction needed to reveal it: prose, lists, tables, fenced code.\n\n**Never fold content behind a control.** `\u003Cdetails>`\u002F`\u003Csummary>` is a browser widget, and a\nterminal has no way to open it: the summary line prints and everything under it does not. The plan\nthen arrives as headings with nothing beneath them, and the failure is silent on **both** sides —\nthe skill believes it reported, and the reader sees no marker saying anything is missing, so a\nhuman confirms a plan whose contents never reached them. What gets folded is whatever ran long,\nwhich is to say the part the decision actually rested on. The same holds for anything else needing\na click: a tab strip, an accordion, a \"show more\".\n\n**Length is handled by shortening, never by hiding.** This is a fixed rule of the skill, not a\nper-run judgement, so it holds however long the list runs. Trim to what the decision needs, group\nthe rest by something the reader already thinks in (ecosystem, kind, verdict) with a count per\ngroup, or split it across sections. What is left out is left out **visibly**: say how many, why,\nand the exact command that shows the rest.\n\n**This binds what the skill presents, not what it writes.** A `\u003Cdetails>` block inside a README, an\nissue body, a pull request description or a docs page is rendered by a browser and is entirely\nlegitimate there. The rule is about the message a human reads to decide — never about the content\nof a file.\n\n\u003C\u002Fskills-plan>\n\n## Guardrails\n\n- **The repo is the source of truth; the guide follows it.** This skill never edits the file it derived a fact from, and never \"fixes\" the repo to match the guide — a mismatch is the guide's defect by definition.\n- **Only `CONTRIBUTING.md`.** No sibling document, no config, no commit.\n- **Plan first; write only after confirmation.** Respect plan-only \u002F dry-run.\n- **Never invent a value.** No default branch by assumption, no gate command by guess, nothing copied out of another repo's guide because it read well there.\n- **Never rewrite authored prose** — the project's voice is not this skill's to normalise, however much shorter it could be.\n- **Attribution-free** — no agent self-naming, no `Generated with`\u002F🤖 line, no session URL.\n- **No secrets** — a setup step is real, copy-pasteable shell: scan it for tokens and `.env` values, and show a placeholder rather than a live one.\n\n## Reference\n\n- **Open it before writing down any repo-specific fact** — the derivation table names the file that owns each one (branch base, gate command, commit convention, package manager), which is what \"derived, not retyped\" comes to in practice. The section catalogue settles where a section sits in the house order, and the reconcile rules settle what a run may rewrite once a guide already exists: [REFERENCE.md](REFERENCE.md).\n- **Fill this on the scaffold job, where there is no guide yet**: [`templates\u002FCONTRIBUTING.template.md`](templates\u002FCONTRIBUTING.template.md).\n- **When the material turns out not to be contributing material at all**, hand it over rather than absorbing it: `write-readme` owns `README.md`, `write-docs` owns the `docs\u002F` tree. A guide that starts explaining architecture belongs in `docs\u002F`; one that starts selling the project belongs in the README.\n\n## Gap report (mandatory final step)\n\nEnd the turn with a short note listing anything [REFERENCE.md](REFERENCE.md) did not cover:\n\n```text\nGap report — improvements for write-contributing:\n- Section \"{name}\" — no catalogue entry; placed after {section}.\n- Fact \"{name}\" — no derivation row; read from {file}.\n- Fact \"{name}\" — no owning file in this repo; asked the user.\n```\n\nIf everything matched: `Gap report: no gaps.` **Only report; do not edit REFERENCE.md yourself** — the user folds gaps back in.\n","# write-contributing\n\n`CONTRIBUTING.md` is the one document that tells a contributor **how work is done in this repo** — which branch to start from, which command has to pass, how a commit is worded, where a bug goes. This skill owns that convention: one house structure, the same in every repo, with the repo-specific values read out of the repo rather than typed in. Structure catalogue, derivation recipes and reconcile rules: [REFERENCE.md](REFERENCE.md). Skeleton to copy: [`templates\u002FCONTRIBUTING.template.md`](templates\u002FCONTRIBUTING.template.md).\n\nIt is the guide's generator **and** its linter — the same skill scaffolds a missing one and reconciles an existing one, because the failure this exists to prevent is not a missing guide but a stale one.\n\n## Derived, not retyped\n\nAlmost nothing in a contributing guide is the guide's own fact. Split every statement in two, and the whole skill follows:\n\n| Kind         | What it is                                                                                                                       | This skill                                                     |\n| :----------- | :------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------- |\n| **Derived**  | A fact some **other file** decides — the branch base, the gate command, the commit convention, the runtime floor, an intake link | **owns it**: reads the owner every run and writes what it says |\n| **Authored** | The project's own prose — what a good PR looks like, the review bar, what this project is picky about                            | **never rewrites it**; may report it as suspect                |\n\nA derived statement is **re-derived on every run**, never carried over from the existing text and never copied from another repo's guide. That is the entire mechanism: a guide assembled from the files it describes cannot contradict them, and a guide reconciled against them stops being able to drift silently.\n\n**A fact with no owning file is asked about, never assumed.** \"The default branch is `main`\" is exactly the assumption that puts a contributor on the wrong branch — and it is the shape of every derivation failure here. Where two candidate owners disagree, that is a **prompt**, not a judgement call ([reconcile](#reconcile--the-guide-exists)).\n\nWhat each statement is derived **from** is the derivation table in [REFERENCE.md](REFERENCE.md#derivation-table) — one row per fact, with its owning file, its fallback chain, and what must never stand in for it.\n\n## Jobs — pick by repo state + intent\n\n| State \u002F intent                                                 | Job           |\n| :------------------------------------------------------------- | :------------ |\n| No `CONTRIBUTING.md`                                           | **scaffold**  |\n| It exists + \"update \u002F fix \u002F align \u002F reconcile it\"              | **reconcile** |\n| It exists + \"document X in it\" (a new contributor-facing step) | **add**       |\n\nOptional command shortcuts in clients that expose them: `write-contributing init`, `write-contributing add \u003Cstep>`, `write-contributing reconcile`. Otherwise infer from repo state and the request. **Always: plan → confirm → apply.**\n\n**Plan-only triggers** — \"just show me\", \"dry run\", \"plan only\", \"nur den Plan\", \"nicht schreiben\": print the plan and the derivation table, write nothing.\n\n## Structure — the house order\n\n| #   | Section               | Include when                                                             | Holds                                                                                |\n| :-- | :-------------------- | :----------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |\n| 1   | Title + intro         | Always                                                                   | One welcoming line; the only place an emoji is allowed                               |\n| 2   | Code of Conduct       | `CODE_OF_CONDUCT.md` exists                                              | Two sentences and the link — never a summary of it                                   |\n| 3   | Reporting issues      | Always                                                                   | One line per intake route, each a link ([derivation](REFERENCE.md#derivation-table)) |\n| 4   | Development setup     | Always                                                                   | Runtime floor, package manager, clone + install                                      |\n| 5   | Adding a new `\u003Cunit>` | The repo has a repeatable contribution unit (a skill, a package, a rule) | The numbered path from empty folder to commit                                        |\n| 6   | Running the suite     | Always                                                                   | The gate first, then the few commands a contributor runs by hand                     |\n| 7   | Branching & PRs       | Always                                                                   | The **base branch**, the commit convention, one concern per PR                       |\n| 8   | Style & quality gates | Hooks or a formatter are configured                                      | What runs on commit, and what to do when it fails                                    |\n| 9   | Releases              | Release automation exists                                                | Two sentences: what cuts a release, from where                                       |\n| 10  | License               | Always                                                                   | The inbound=outbound sentence and the link                                           |\n\n**A section whose signal is absent is left out, not written empty.** \"This project has no release process\" is a line that tells a contributor nothing and goes stale the day one appears.\n\n### Style rules\n\n- **Emoji in the intro line only** — never in a heading. A contributing guide is not the README; the section emojis `write-readme` prescribes stop at the README's front door.\n- **Second person, imperative, short.** The reader is mid-task.\n- **Callouts** use `> [!TIP]` \u002F `> [!IMPORTANT]` \u002F `> [!NOTE]`, never a plain blockquote.\n- **Tables** are left-aligned (`| :--- |`).\n- **Never transcribe a file — any file, any list.** The rule is about **every enumeration**, not one table: a list whose owner is another file is **linked, not copied**, whatever it enumerates — the manifest's scripts, the artifacts a sync or codegen command writes, a unit's frontmatter fields, the globs a hook matches. The suite table is only its most familiar case: it names the gate and the handful of commands a contributor types, not every script in the manifest. **And where such a list must appear, it appears without a count in front of it** — \"regenerates the four artifacts\" is the one claim no gate can check, and it goes stale the day a fifth is added while every item beside it still reads true. Link the owner and let the owner say how many; a transcribed list is the second-most-common stale block in any guide, after the branch name.\n- **Repo files are linked relatively** (`CODE_OF_CONDUCT.md`, `SECURITY.md`, `LICENSE`), forge routes absolutely (a `?template=` new-issue URL). A relative link is what survives a fork.\n\n## Scaffold — no guide yet\n\n1. **Resolve the config** — `pr.base`, root `verify`, root `language` ([REFERENCE.md](REFERENCE.md#config)).\n2. **Derive every fact** in the [derivation table](REFERENCE.md#derivation-table). Anything with no owner and no answer: **ask**.\n3. **Pick the sections** — the structure above, dropping each whose signal the repo does not show, and naming the drops in the plan.\n4. **Show the plan**: the section list, plus the derived facts as `fact → value → the file it came from`. That table is the part a human can actually check; the prose is the part they cannot.\n5. **On confirm** — fill [`templates\u002FCONTRIBUTING.template.md`](templates\u002FCONTRIBUTING.template.md) and write `CONTRIBUTING.md`.\n\n## Add — the guide exists, document one more step\n\nA human asks for a contributor-facing step the guide has never carried: a one-time setup command the install does not do, a second intake route, the path for adding a new unit. **Distinct from the reconcile pass's [Add](#reconcile--the-guide-exists) bullet** — that one is a _derived_ span whose owner already exists and the guide merely never mentioned, found by the pass itself; this one is a request, and its content may have no owning file at all.\n\n1. **Place it by the catalogue, not by the request's wording.** The step belongs in whichever [structure](#structure--the-house-order) row it matches. A step matching **no** row gets a section of its own, at the position the [catalogue](REFERENCE.md#section-catalogue) suggests, and the plan says so rather than deciding quietly.\n2. **The right section may not exist yet.** A repo that has just grown a release flow carries no Releases section. Then this job **creates that one section**, in house order — and no other.\n3. **Derive whatever the new text states.** The [derivation table](REFERENCE.md#derivation-table) binds here exactly as in a scaffold: a step that names a branch, a command or a file reads it from the owning file, never from how the request phrased it. A fact with no owner is **asked about**, not assumed.\n4. **Everything around it stays byte-identical.** Authored prose in the same section is untouched, and no other section is re-derived — re-deriving the whole guide is the **reconcile** job, and the user asked for this step. Drift noticed in passing is **named in the report**, never fixed here; offer the reconcile pass instead.\n5. **Plan → confirm → apply** — show the placement, the derived values with their sources, and the diff.\n\n## Reconcile — the guide exists\n\nDesired-state and idempotent — a `--fix` linter over one file. Running it twice changes nothing the second time.\n\n1. **Read the whole guide fresh**, then every owning file it makes a claim about. Both are live state; neither is cached.\n2. **Classify each span** derived or authored, then group the plan into four:\n   - **Rewrite** — derived, and it contradicts its owner. The owner wins, always: the repo is right and the guide follows. (`Branch off main` where `pr.base` is `dev`.)\n   - **Add** — derived and missing. The repo grew a gate, an intake template, a hook the guide never mentions.\n   - **Prompt** — derived and ambiguous. Two owners disagree — `engines` says one runtime, the CI matrix another — so the run **asks** instead of picking.\n   - **Report only** — authored prose that reads stale, a section fitting nothing, a dead link, a detected secret. Named in the report, **never auto-edited**.\n3. **Show the plan and the diff**; on confirm, apply. **Never rewrite authored prose. Only touch `CONTRIBUTING.md`.**\n\n**A derived span whose owner is gone** — a command no longer in the manifest, a workflow deleted — is a **removal**, confirmed span by span and never in bulk: an owner that vanished is as often a rename as a deletion.\n\n\u003Cskills-plan>\n\n## Presenting the plan\n\nEverything this skill puts in front of a human — plan, preview, candidate list, findings report —\nis read **once, in a terminal**, and answered there. So **every section of it renders on arrival**,\nwith no interaction needed to reveal it: prose, lists, tables, fenced code.\n\n**Never fold content behind a control.** `\u003Cdetails>`\u002F`\u003Csummary>` is a browser widget, and a\nterminal has no way to open it: the summary line prints and everything under it does not. The plan\nthen arrives as headings with nothing beneath them, and the failure is silent on **both** sides —\nthe skill believes it reported, and the reader sees no marker saying anything is missing, so a\nhuman confirms a plan whose contents never reached them. What gets folded is whatever ran long,\nwhich is to say the part the decision actually rested on. The same holds for anything else needing\na click: a tab strip, an accordion, a \"show more\".\n\n**Length is handled by shortening, never by hiding.** This is a fixed rule of the skill, not a\nper-run judgement, so it holds however long the list runs. Trim to what the decision needs, group\nthe rest by something the reader already thinks in (ecosystem, kind, verdict) with a count per\ngroup, or split it across sections. What is left out is left out **visibly**: say how many, why,\nand the exact command that shows the rest.\n\n**This binds what the skill presents, not what it writes.** A `\u003Cdetails>` block inside a README, an\nissue body, a pull request description or a docs page is rendered by a browser and is entirely\nlegitimate there. The rule is about the message a human reads to decide — never about the content\nof a file.\n\n\u003C\u002Fskills-plan>\n\n## Guardrails\n\n- **The repo is the source of truth; the guide follows it.** This skill never edits the file it derived a fact from, and never \"fixes\" the repo to match the guide — a mismatch is the guide's defect by definition.\n- **Only `CONTRIBUTING.md`.** No sibling document, no config, no commit.\n- **Plan first; write only after confirmation.** Respect plan-only \u002F dry-run.\n- **Never invent a value.** No default branch by assumption, no gate command by guess, nothing copied out of another repo's guide because it read well there.\n- **Never rewrite authored prose** — the project's voice is not this skill's to normalise, however much shorter it could be.\n- **Attribution-free** — no agent self-naming, no `Generated with`\u002F🤖 line, no session URL.\n- **No secrets** — a setup step is real, copy-pasteable shell: scan it for tokens and `.env` values, and show a placeholder rather than a live one.\n\n## Reference\n\n- **Open it before writing down any repo-specific fact** — the derivation table names the file that owns each one (branch base, gate command, commit convention, package manager), which is what \"derived, not retyped\" comes to in practice. The section catalogue settles where a section sits in the house order, and the reconcile rules settle what a run may rewrite once a guide already exists: [REFERENCE.md](REFERENCE.md).\n- **Fill this on the scaffold job, where there is no guide yet**: [`templates\u002FCONTRIBUTING.template.md`](templates\u002FCONTRIBUTING.template.md).\n- **When the material turns out not to be contributing material at all**, hand it over rather than absorbing it: `write-readme` owns `README.md`, `write-docs` owns the `docs\u002F` tree. A guide that starts explaining architecture belongs in `docs\u002F`; one that starts selling the project belongs in the README.\n\n## Gap report (mandatory final step)\n\nEnd the turn with a short note listing anything [REFERENCE.md](REFERENCE.md) did not cover:\n\n```text\nGap report — improvements for write-contributing:\n- Section \"{name}\" — no catalogue entry; placed after {section}.\n- Fact \"{name}\" — no derivation row; read from {file}.\n- Fact \"{name}\" — no owning file in this repo; asked the user.\n```\n\nIf everything matched: `Gap report: no gaps.` **Only report; do not edit REFERENCE.md yourself** — the user folds gaps back in.\n",{"name":5,"metadata":24,"description":7,"allowed-tools":26},{"summary":25},"Writes and reconciles CONTRIBUTING.md in the house style, deriving every repo fact from the file that owns it.",[27,28,29,30,31,32,33,34,35],"Read","Write","Edit","Glob","Grep","Bash(jq:*)","Bash(grep:*)","Bash(git symbolic-ref:*)","Bash(gh repo view:*)","main","0343b3844cdfe00ebabe556f2a63c0515208e92c","skills\u002Fdocs\u002Fwrite-contributing",0,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills","https:\u002F\u002Fgithub.com\u002FTitusKirch","https:\u002F\u002Fkirch.dev\u002F","💼 Self-employed Web Developer\r\n🎓 B. Sc. Computer Science","2026-11-02 00:46:17",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":57},[47,50,53],{"tool":48,"command":49},"npx","npx skills add TitusKirch\u002Fskills --skill write-contributing",{"tool":51,"command":52},"bunx","bunx skills add TitusKirch\u002Fskills --skill write-contributing",{"tool":54,"command":55},"pnpm","pnpm dlx skills add TitusKirch\u002Fskills --skill write-contributing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fwrite-contributing\u002FSKILL.md",true,[59,65,69],{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"REFERENCE.md","REFERENCE","参考文档",20389,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fwrite-contributing\u002FREFERENCE.md",{"path":66,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":67,"sourceHtmlUrl":68},"templates\u002FCONTRIBUTING.template.md",3279,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fwrite-contributing\u002Ftemplates\u002FCONTRIBUTING.template.md",{"path":70,"resourceType":71,"resourceTypeDesc":72,"sizeBytes":73,"sourceHtmlUrl":74},"templates\u002Fresolve-config.sh","SCRIPT","脚本",2402,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fwrite-contributing\u002Ftemplates\u002Fresolve-config.sh",[76,83,90,97,104,111],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M74FV6SYWA6MEBCX3EY64484","gamma","The third fixture skill — carries the worklock, plan and tldr blocks, and names the resolver without hosting the config block.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fregistry\u002Fskills\u002Fwork\u002Fgamma\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M74FV4K7PNY8GTJH2M8ZTJGT","beta","The second fixture skill — carries the tagged blocks but no config block.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fregistry\u002Fskills\u002Frepo\u002Fbeta\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M74FV2JYBQ3VRP180AZEVQFC","alpha","The first fixture skill — carries the config block and the resolver.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fregistry\u002Fskills\u002Frepo\u002Falpha\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M74FTVVHVDTMTP0EX4W924NK","work-review","Reviews a single tracked issue's pushed implementation across GitHub (gh), GitLab (glab), Linear (MCP) or local issue files as a fresh, independent agent — reads the issue's requirements and the pushed diff, adversarially checks whether the work is correct and complete, and writes a verdict that routes the issue to done (accepted), changes-requested (feedback, back to the implement loop), needs-human (escalation), or blocked. It never implements or fixes anything — review only. It also applies a human's verdict on a needs-human issue. Tracker, labels and the round cap come from the committed config (.tituskirch-skills.json). Use when the user wants to review, check, or sign off one specific issue's AI work, mentions an issue awaiting review, or says things like \"review issue 42\", \"check the work on issue 42\", \"reviewe Issue 42\", or gives a verdict on an escalated issue.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwork\u002Fwork-review\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":19},"01M74FTNQ1RCJTZ929GNJ2FBX5","work-review-queue","Drains a repo's queue of issues awaiting AI review across GitHub (gh), GitLab (glab), Linear (MCP) or local issue files — selects every issue in review, then reviews each with a fresh, independent agent by delegating to work-review, routing each to done, changes-requested (back to the implement loop), needs-human, or blocked. Starts by reconciling issues whose PR a human merged or closed out-of-band. Honours a per-run cap, single-flight-locked with a lock separate from the implement loop's, so review and implement drains run concurrently. Use when the user wants to review, drain, or auto-review the pushed AI work, run the review loop, says things like \"review the queue\", \"reviewe die Issues\", \"drain the review queue\", or starts a repeating driver.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwork\u002Fwork-review-queue\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":19},"01M74FTFKF2GBCKMKKHN5QJW0G","work-implement","Implements a single tracked issue across GitHub (gh), GitLab (glab), Linear (MCP) or local issue files — claims it via the lifecycle label, implements on a branch (fresh from ready, or re-work from changes-requested after review feedback), runs the repo's checks, commits and PUSHES, and hands the issue to the review loop by advancing the label to review. It never reviews its own work — the separate work-review skill does that. Tracker, label lifecycle and branch strategy come from the committed config (.tituskirch-skills.json). Use when the user wants to work, implement, action or pick up one specific issue or ticket, mentions an ai-ready issue, or says things like \"work issue 42\", \"arbeite Issue 42 ab\", \"implementiere Ticket X\", or \"address the review feedback on issue Y\".","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwork\u002Fwork-implement\u002FSKILL.md",[],[]]