[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M787HP2484TER1ZEMM7HSVJV":3,"skill-same:01M787HP2484TER1ZEMM7HSVJV":62},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":16,"publishedAt":17,"linkOnly":18,"markdownContent":19,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":12,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":27,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M787HP2484TER1ZEMM7HSVJV","rewrite",null,"neolao\u002Fclaude-plugin-vibe","neolao","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F149506?v=4","01M787F66EN3C5HEKZCY53VPY8","01M787F67MZYM53GYFZWR4M59E",0,"MIT","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frewrite\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: rewrite\ndescription: Rework an existing text for clarity by named rules — Williams, Clark & Haviland's given-new contract, Gibson's dependency locality, ISO 24495-1, Ousterhout for code comments — defect-by-defect rewrite, meaning-preservation check by a sub-agent; the output is always in the source text's language. Invoked by the build workflow in `mode: direct` on the report it is about to show the user, never directly by users.\nargument-hint: \"[mode: direct] [sentence, paragraph, file path or folder — empty uses the text under discussion]\"\nuser-invocable: false\nversion: 1.2.1\nmodel: claude-sonnet-5-5\n---\n\n# vibe:rewrite — Rework for Clarity\n\n## Golden rule\nA shorter sentence is not a clearer sentence. Flesch, Gunning Fog and SMOG score only the length of sentences and words — optimizing for them rewards a choppy text that forces the reader to rebuild the links that were just cut. This protocol works on what explains the cost of reading, never on what can be counted.\n\n## When to run\nOn a text **that already exists** and that the user wants reworked. Not on a text to be produced: there, nothing can be diagnosed, and these principles belong to revision, not drafting — Williams is explicit, thinking about them while drafting prevents finishing.\n\nDo not trigger for a translation, a spelling or grammar fix alone, or a code review (the code itself is never touched here — see the matching invariant; code review belongs to the build workflow's internal review).\n\n## Scope & language\nThe target is one of five kinds, and the kind changes the protocol:\n\n| Target | Diagnosis | Control sub-agent | Writing |\n|---|---|---|---|\n| A single sentence given inline | `sentence.md` | no — the user sees everything at a glance | none |\n| A paragraph given inline | `sentence.md` | **yes** — re-merging sentences is exactly where a link gets invented | none |\n| A document | `sentence.md` + `document.md` | yes | after validation |\n| A source file | `sentence.md` + `code-comments.md` | yes | after validation |\n| A corpus (> 3 files) | inventory first (step 2) | one per retained file | after validation |\n\n**Direct mode.** A first line `mode: direct` in `$ARGUMENTS`, before the text, means the caller is a vibe workflow handing over text it has just produced (a report, a plan for the user) and wants it back clearer, without a dialogue. The protocol is the same up to the check (steps 1 and 3 to 5, no corpus inventory, the reader framed from what the caller says without a question); steps 6 and 7 change: no before\u002Fafter table, no question, no file written. Return the rewritten text itself, then the questions to the author as a list the caller may surface, then the closing block in its `direct` form. Two check passes maximum, as always; a passage still contested stays in its original wording and is named in the block. Inline text only: a file path in direct mode is refused with one line.\n\n**The output is always in the language of the source.** An English text stays English, a French text stays French, a Japanese text stays Japanese. Translating is not clarifying. Only the instructions of this skill are in English; the diagnosis, the before\u002Fafter table and the questions to the author are written in the language the conversation is conducted in, and the proposed text itself in the language of the source.\n\n## Behaviour\n\n1. **Frame the reader.** Identify the target reader and their goal (ISO 5.1.2 \u002F 5.1.3) — \"clear\" means nothing without a reader: the same paragraph is limpid for a developer on the team and opaque for a customer. If the context does not allow it to be inferred, ask **a single** question via `AskUserQuestion`; this is not `vibe:clarify`, there is no tree to build here.\n\n2. **On a corpus (> 3 files), inventory before rewriting.** Render a table \"file → number of defects per family\", then ask via `AskUserQuestion` which files to rework — a rewrite proposal over fifty documents is unreadable, and the user usually has only a few files in mind.\n\n3. **Diagnose before rewriting.** Read the target, list the **located** defects, each labelled with the rule that explains it (`W2`, `GN1`, `G3`, `ISO 5.2.2`, `OUST-2`) — a global rewrite \"by feel\" can be neither checked, nor discussed, nor refused point by point.\n\n   The diagnosis is a list, **one entry per defect**: the passage quoted between quotation marks, the rule identifier taken from a grid, what the defect costs the target reader. A sentence carrying two defects has two entries; an overall observation (\"the whole text is nominal: W2\") does not replace the entries, it can only introduce them. For the survey, ask two questions of every sentence of the original: **who acts**, and **what is the action**. An actor named anywhere other than as subject (in an agent complement, \"by the security team\", or in a noun or verb complement, \"with the referent\", \"to the requester\") or named nowhere is a `W1` entry, even if the rewrite keeps the construction; an action carried by a noun is a `W2` entry.\n   - [references\u002Fsentence.md](references\u002Fsentence.md) — **always**. Sentence and paragraph level: Williams, given-new contract, dependency locality theory.\n   - [references\u002Fdocument.md](references\u002Fdocument.md) — as soon as the target is a whole document or a corpus. Document level: ISO 24495-1.\n   - [references\u002Fcode-comments.md](references\u002Fcode-comments.md) — **only** if the target is a source file.\n\n   Each grid carries its own counter-rules section. Read them with the rules, not after: that is what prevents over-correction.\n\n   Also record, one by one, the **missing links**: a subject arriving without an antecedent, a fact juxtaposed with no stated relation to the previous one, a noun or a verb without the complement the target reader needs (\"a cache\" of what, \"measured\" what, \"the load\" of what). Go through every sentence of the original for these links, one at a time, before rewriting anything. Each one will be either restored with the words of the original, or carried as a question to the author at step 6 — never neither.\n\n4. **Rewrite defect by defect**, under the invariants below, following the order of application given at the end of `sentence.md` when several rules contradict one another on the same passage. Re-merging sentences is not condensing them: no load-bearing word removed, no shorter construction substituted for the original — no pronoun or auxiliary dropped, no relative clause reduced to a participle (\"A cache exists. It is invalidated on deployment.\" becomes neither \"has a cache invalidated on deployment\" nor \"A cache exists, invalidated on deployment\").\n\n5. **Have it checked.** Launch an agent via the Agent tool with `subagent_type: \"general-purpose\"`, `model: \"sonnet\"` and `run_in_background: false` — this is judgement on meaning preservation, not checklist ticking, and its verdict must come back within this same turn. The `prompt` opens with \"Invoke no skill and launch no agent.\" and then contains:\n   - the full content of [references\u002Fcontrol.md](references\u002Fcontrol.md), read with `Read` just before the call and pasted as is — not summarized from memory;\n   - the **original version** and the **rewritten version**, set side by side;\n   - the target reader identified at step 1, and the user's request quoted **verbatim** — the sub-agent does not see the conversation, and a paraphrase would carry the same misreading as the rewrite;\n   - the **read-only** instruction: it modifies no file and proposes no replacement rewrite, it reports what is lost.\n\n   Verdict `[PASS]` or `[FAIL]`. A verdict that is neither, or that contains both, counts as `[FAIL]`. A tool error relaunches the single check concerned, without consuming a pass.\n   - On `[FAIL]`: fix and relaunch. Fixing a contested passage means **removing** what the check contests (the unestablished claim, the added word), not rephrasing it: a new wording often carries a new error, and a rewrite that says less but says it right passes. **2 passes maximum** — this sub-agent is a non-regression guard, not a style-improvement loop. Beyond that, leave the passage(s) concerned **in their original version** and say so in the closing block.\n   - Skipped only when the target is **a single sentence** given inline. An inline paragraph is checked: nothing is written, but re-merging sentences is where a causal link the original did not give gets invented.\n   - On a corpus: one sub-agent per file, launched in parallel in the same message.\n\n6. **Present, then write after validation.** Render a before\u002Fafter table, titled \"proposed\" (never \"applied\": nothing is written until the user has answered), one row per rewrite, with the named rule alongside. The \"after\" column contains **the exact text** proposed, in the language of the source — never a description of what it will say: the user can only arbitrate what they read. Below the table, a list **Questions to the author**, one line per missing link recorded at step 3 that was not restored, including in a passage left intact after the check failed (a rewrite attempted then withdrawn does not waive its question: the link is still missing) — none is omitted, even if it seems minor: it is for the reader of the original to say what the text does not say. Then `AskUserQuestion`: apply everything \u002F apply a selection \u002F apply nothing — **also on an inline target**, where the question is about which rewrites to keep. If the tool is not offered, ask the same question in text, right before the awaiting closing block. Settle that choice **before** composing the output (the tool is offered or it is not: a `ToolSearch` to find it happens upstream): a tool call between the output and the question splits the message in two, and only the last one is read. The message that carries the question therefore **itself** contains the diagnosis, the table, the questions to the author and the closing block; never write \"the table above\": if a tool was called after the output, copy everything back into the final message. **No file is written before the answer** — the user is the author of the text, a rewrite applied by default takes away the only arbitration that matters.\n\n7. **Close** with one of the blocks below, at the end of the last message, once the check's verdict is back: never end the turn on a tool call. That last message carries **the whole** output of step 6 — diagnosis, before\u002Fafter table, questions to the author, validation question, block — not the block alone: a message composed before the check is no longer read once the verdict is back. **In direct mode** that message carries only the rewritten text, the questions to the author and the block — no diagnosis, no table, no account of the check passes or of what the check contested (the block names what was left untouched), no preamble before the text.\n\n## Invariants\nWhat a rewrite never changes:\n\n- **The meaning.** No information removed, added or qualified. Removing a hedge makes the assertion stronger — that is a change of meaning, not of form (Williams: the most common intensifier is the absence of a hedge). A connector is information: writing *thanks to*, *therefore* or *because* between two facts the original juxtaposed asserts a cause it did not give. When the antecedent or the link is missing from the source (what a cache caches, whose load drops), restore it with the words of the original only; otherwise, **report it as a question to the author** rather than guess it.\n- **The designated responsibility.** Putting a character as subject, denominalizing or depassivizing shifts who is designated as responsible — Williams demonstrates it on an automobile recall letter, and ISO 5.1.6 forbids concealing content the reader needs to know. The shift may be desirable, but it is **reported** in the closing block, it is not done in silence. Never invent an actor the source does not name (\"I\", \"we\", \"the team\"): when the source names none, restructure without one (passive or noun subject) and carry the missing actor as a question to the author.\n- **The imposed vocabulary**: glossary terms, product names, code identifiers, quotes, figures, URLs. Non-intuitive corollary (GN3): **one concept, one word** — elegant variation forces the reader into a gratuitous bridge, so the instinct to avoid repetition (strong in French prose, Fowler's \"elegant variation\" in English) is a fault here, not a quality.\n- **The Markdown structure**, the frontmatter, the link anchors, the heading levels.\n- **No length target.** Never aim at a Flesch, Gunning Fog or SMOG score, nor at a number of words per sentence, nor cite them as justification. Do not quantify the sentence lengths of the text either (\"3 to 6 words\", \"under 15 words\") in the diagnosis: the defect is the cut link, never the word count. Cutting a sentence is forbidden when it forces a bridging inference (GN1, GN2); **lengthening is allowed** when it restores the old→new chain. The dependency locality theory says nothing against long sentences: it says something against long dependencies (G6).\n- **What must stay complex stays complex.** Williams: *no simpler than they deserve, but no more difficult than they have to be*. A long sentence with short dependencies is good; a useful nominalization and a passive motivated by the flow are not defects.\n- **Never a translation.**\n- **On a source file, only the comments and docstrings are rewritten**, never the code — changing a line of code is not an editorial rework, and falls outside the mandate given.\n\n## Output format\nEnd with a block, in one of these four exact forms. `\u003Cn>` is a number (the number of rewrites that appear in the before\u002Fafter table; at `0`, the message proposes applying no change) and the word that follows is `rewrite(s)`, never another unit (\"paragraph\", \"sentences\"); `\u003Ctarget>` names the target.\n\n**As long as the user has not answered the question of step 6** — which is the case of the message that asks it, whether there is a file to write or not. Nothing is applied at this stage: never put `✅ [Rewrite applied]` there.\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) proposed on \u003Ctarget> · Check \u003C✅ | ❌ | not required (single sentence)>\n⏸️ [Rewrite awaiting validation]\n---\n```\nWith a check in `[FAIL]` after 2 passes, add `· left untouched: \u003Cpassages>` on the `⏸️` line, including when no rewrite survived (`0 rewrite(s) proposed`): the `⚠️ [Rewrite partial]` block never comes in this message, only after the user's answer.\n\nThe next three forms close the message **that follows the user's answer**.\n\n**If the check is `[PASS]`** (or was not required — single sentence inline):\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) on \u003Ctarget> · Check ✅\n✅ [Rewrite applied]\n---\n```\n\n**If the check stays `[FAIL]` after 2 passes**:\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) on \u003Ctarget> · Check ❌\n⚠️ [Rewrite partial] — \u003Csummary of the last [FAIL]> · left untouched: \u003Cpassages>\n---\n```\n\n**If the user declines the rewrites**:\n```\n---\n✍️ Rewrite — 🚫 [Rewrite not applied — declined by the user]\n---\n```\n\n**In direct mode**, the only block, closing the single message that carries the rewritten text:\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) applied directly · Check \u003C✅ | ❌>\n---\n```\nWith a check in `[FAIL]` after 2 passes, add `· left untouched: \u003Cpassages>` on the same line.\n\nIn the awaiting form, the two applied forms and the direct form, add before the final `---` one line per detected shift:\n`↪ Responsibility shift — \u003Crule>: \u003Cactor now named, or now hidden>`\n\nThis block appears only when this skill has actually run: its absence directly signals that no diagnosis took place. Other skills (`vibe:usage-report`, `vibe:debrief`) may add their own block after this one.\n","# vibe:rewrite — Rework for Clarity\n\n## Golden rule\nA shorter sentence is not a clearer sentence. Flesch, Gunning Fog and SMOG score only the length of sentences and words — optimizing for them rewards a choppy text that forces the reader to rebuild the links that were just cut. This protocol works on what explains the cost of reading, never on what can be counted.\n\n## When to run\nOn a text **that already exists** and that the user wants reworked. Not on a text to be produced: there, nothing can be diagnosed, and these principles belong to revision, not drafting — Williams is explicit, thinking about them while drafting prevents finishing.\n\nDo not trigger for a translation, a spelling or grammar fix alone, or a code review (the code itself is never touched here — see the matching invariant; code review belongs to the build workflow's internal review).\n\n## Scope & language\nThe target is one of five kinds, and the kind changes the protocol:\n\n| Target | Diagnosis | Control sub-agent | Writing |\n|---|---|---|---|\n| A single sentence given inline | `sentence.md` | no — the user sees everything at a glance | none |\n| A paragraph given inline | `sentence.md` | **yes** — re-merging sentences is exactly where a link gets invented | none |\n| A document | `sentence.md` + `document.md` | yes | after validation |\n| A source file | `sentence.md` + `code-comments.md` | yes | after validation |\n| A corpus (> 3 files) | inventory first (step 2) | one per retained file | after validation |\n\n**Direct mode.** A first line `mode: direct` in `$ARGUMENTS`, before the text, means the caller is a vibe workflow handing over text it has just produced (a report, a plan for the user) and wants it back clearer, without a dialogue. The protocol is the same up to the check (steps 1 and 3 to 5, no corpus inventory, the reader framed from what the caller says without a question); steps 6 and 7 change: no before\u002Fafter table, no question, no file written. Return the rewritten text itself, then the questions to the author as a list the caller may surface, then the closing block in its `direct` form. Two check passes maximum, as always; a passage still contested stays in its original wording and is named in the block. Inline text only: a file path in direct mode is refused with one line.\n\n**The output is always in the language of the source.** An English text stays English, a French text stays French, a Japanese text stays Japanese. Translating is not clarifying. Only the instructions of this skill are in English; the diagnosis, the before\u002Fafter table and the questions to the author are written in the language the conversation is conducted in, and the proposed text itself in the language of the source.\n\n## Behaviour\n\n1. **Frame the reader.** Identify the target reader and their goal (ISO 5.1.2 \u002F 5.1.3) — \"clear\" means nothing without a reader: the same paragraph is limpid for a developer on the team and opaque for a customer. If the context does not allow it to be inferred, ask **a single** question via `AskUserQuestion`; this is not `vibe:clarify`, there is no tree to build here.\n\n2. **On a corpus (> 3 files), inventory before rewriting.** Render a table \"file → number of defects per family\", then ask via `AskUserQuestion` which files to rework — a rewrite proposal over fifty documents is unreadable, and the user usually has only a few files in mind.\n\n3. **Diagnose before rewriting.** Read the target, list the **located** defects, each labelled with the rule that explains it (`W2`, `GN1`, `G3`, `ISO 5.2.2`, `OUST-2`) — a global rewrite \"by feel\" can be neither checked, nor discussed, nor refused point by point.\n\n   The diagnosis is a list, **one entry per defect**: the passage quoted between quotation marks, the rule identifier taken from a grid, what the defect costs the target reader. A sentence carrying two defects has two entries; an overall observation (\"the whole text is nominal: W2\") does not replace the entries, it can only introduce them. For the survey, ask two questions of every sentence of the original: **who acts**, and **what is the action**. An actor named anywhere other than as subject (in an agent complement, \"by the security team\", or in a noun or verb complement, \"with the referent\", \"to the requester\") or named nowhere is a `W1` entry, even if the rewrite keeps the construction; an action carried by a noun is a `W2` entry.\n   - [references\u002Fsentence.md](references\u002Fsentence.md) — **always**. Sentence and paragraph level: Williams, given-new contract, dependency locality theory.\n   - [references\u002Fdocument.md](references\u002Fdocument.md) — as soon as the target is a whole document or a corpus. Document level: ISO 24495-1.\n   - [references\u002Fcode-comments.md](references\u002Fcode-comments.md) — **only** if the target is a source file.\n\n   Each grid carries its own counter-rules section. Read them with the rules, not after: that is what prevents over-correction.\n\n   Also record, one by one, the **missing links**: a subject arriving without an antecedent, a fact juxtaposed with no stated relation to the previous one, a noun or a verb without the complement the target reader needs (\"a cache\" of what, \"measured\" what, \"the load\" of what). Go through every sentence of the original for these links, one at a time, before rewriting anything. Each one will be either restored with the words of the original, or carried as a question to the author at step 6 — never neither.\n\n4. **Rewrite defect by defect**, under the invariants below, following the order of application given at the end of `sentence.md` when several rules contradict one another on the same passage. Re-merging sentences is not condensing them: no load-bearing word removed, no shorter construction substituted for the original — no pronoun or auxiliary dropped, no relative clause reduced to a participle (\"A cache exists. It is invalidated on deployment.\" becomes neither \"has a cache invalidated on deployment\" nor \"A cache exists, invalidated on deployment\").\n\n5. **Have it checked.** Launch an agent via the Agent tool with `subagent_type: \"general-purpose\"`, `model: \"sonnet\"` and `run_in_background: false` — this is judgement on meaning preservation, not checklist ticking, and its verdict must come back within this same turn. The `prompt` opens with \"Invoke no skill and launch no agent.\" and then contains:\n   - the full content of [references\u002Fcontrol.md](references\u002Fcontrol.md), read with `Read` just before the call and pasted as is — not summarized from memory;\n   - the **original version** and the **rewritten version**, set side by side;\n   - the target reader identified at step 1, and the user's request quoted **verbatim** — the sub-agent does not see the conversation, and a paraphrase would carry the same misreading as the rewrite;\n   - the **read-only** instruction: it modifies no file and proposes no replacement rewrite, it reports what is lost.\n\n   Verdict `[PASS]` or `[FAIL]`. A verdict that is neither, or that contains both, counts as `[FAIL]`. A tool error relaunches the single check concerned, without consuming a pass.\n   - On `[FAIL]`: fix and relaunch. Fixing a contested passage means **removing** what the check contests (the unestablished claim, the added word), not rephrasing it: a new wording often carries a new error, and a rewrite that says less but says it right passes. **2 passes maximum** — this sub-agent is a non-regression guard, not a style-improvement loop. Beyond that, leave the passage(s) concerned **in their original version** and say so in the closing block.\n   - Skipped only when the target is **a single sentence** given inline. An inline paragraph is checked: nothing is written, but re-merging sentences is where a causal link the original did not give gets invented.\n   - On a corpus: one sub-agent per file, launched in parallel in the same message.\n\n6. **Present, then write after validation.** Render a before\u002Fafter table, titled \"proposed\" (never \"applied\": nothing is written until the user has answered), one row per rewrite, with the named rule alongside. The \"after\" column contains **the exact text** proposed, in the language of the source — never a description of what it will say: the user can only arbitrate what they read. Below the table, a list **Questions to the author**, one line per missing link recorded at step 3 that was not restored, including in a passage left intact after the check failed (a rewrite attempted then withdrawn does not waive its question: the link is still missing) — none is omitted, even if it seems minor: it is for the reader of the original to say what the text does not say. Then `AskUserQuestion`: apply everything \u002F apply a selection \u002F apply nothing — **also on an inline target**, where the question is about which rewrites to keep. If the tool is not offered, ask the same question in text, right before the awaiting closing block. Settle that choice **before** composing the output (the tool is offered or it is not: a `ToolSearch` to find it happens upstream): a tool call between the output and the question splits the message in two, and only the last one is read. The message that carries the question therefore **itself** contains the diagnosis, the table, the questions to the author and the closing block; never write \"the table above\": if a tool was called after the output, copy everything back into the final message. **No file is written before the answer** — the user is the author of the text, a rewrite applied by default takes away the only arbitration that matters.\n\n7. **Close** with one of the blocks below, at the end of the last message, once the check's verdict is back: never end the turn on a tool call. That last message carries **the whole** output of step 6 — diagnosis, before\u002Fafter table, questions to the author, validation question, block — not the block alone: a message composed before the check is no longer read once the verdict is back. **In direct mode** that message carries only the rewritten text, the questions to the author and the block — no diagnosis, no table, no account of the check passes or of what the check contested (the block names what was left untouched), no preamble before the text.\n\n## Invariants\nWhat a rewrite never changes:\n\n- **The meaning.** No information removed, added or qualified. Removing a hedge makes the assertion stronger — that is a change of meaning, not of form (Williams: the most common intensifier is the absence of a hedge). A connector is information: writing *thanks to*, *therefore* or *because* between two facts the original juxtaposed asserts a cause it did not give. When the antecedent or the link is missing from the source (what a cache caches, whose load drops), restore it with the words of the original only; otherwise, **report it as a question to the author** rather than guess it.\n- **The designated responsibility.** Putting a character as subject, denominalizing or depassivizing shifts who is designated as responsible — Williams demonstrates it on an automobile recall letter, and ISO 5.1.6 forbids concealing content the reader needs to know. The shift may be desirable, but it is **reported** in the closing block, it is not done in silence. Never invent an actor the source does not name (\"I\", \"we\", \"the team\"): when the source names none, restructure without one (passive or noun subject) and carry the missing actor as a question to the author.\n- **The imposed vocabulary**: glossary terms, product names, code identifiers, quotes, figures, URLs. Non-intuitive corollary (GN3): **one concept, one word** — elegant variation forces the reader into a gratuitous bridge, so the instinct to avoid repetition (strong in French prose, Fowler's \"elegant variation\" in English) is a fault here, not a quality.\n- **The Markdown structure**, the frontmatter, the link anchors, the heading levels.\n- **No length target.** Never aim at a Flesch, Gunning Fog or SMOG score, nor at a number of words per sentence, nor cite them as justification. Do not quantify the sentence lengths of the text either (\"3 to 6 words\", \"under 15 words\") in the diagnosis: the defect is the cut link, never the word count. Cutting a sentence is forbidden when it forces a bridging inference (GN1, GN2); **lengthening is allowed** when it restores the old→new chain. The dependency locality theory says nothing against long sentences: it says something against long dependencies (G6).\n- **What must stay complex stays complex.** Williams: *no simpler than they deserve, but no more difficult than they have to be*. A long sentence with short dependencies is good; a useful nominalization and a passive motivated by the flow are not defects.\n- **Never a translation.**\n- **On a source file, only the comments and docstrings are rewritten**, never the code — changing a line of code is not an editorial rework, and falls outside the mandate given.\n\n## Output format\nEnd with a block, in one of these four exact forms. `\u003Cn>` is a number (the number of rewrites that appear in the before\u002Fafter table; at `0`, the message proposes applying no change) and the word that follows is `rewrite(s)`, never another unit (\"paragraph\", \"sentences\"); `\u003Ctarget>` names the target.\n\n**As long as the user has not answered the question of step 6** — which is the case of the message that asks it, whether there is a file to write or not. Nothing is applied at this stage: never put `✅ [Rewrite applied]` there.\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) proposed on \u003Ctarget> · Check \u003C✅ | ❌ | not required (single sentence)>\n⏸️ [Rewrite awaiting validation]\n---\n```\nWith a check in `[FAIL]` after 2 passes, add `· left untouched: \u003Cpassages>` on the `⏸️` line, including when no rewrite survived (`0 rewrite(s) proposed`): the `⚠️ [Rewrite partial]` block never comes in this message, only after the user's answer.\n\nThe next three forms close the message **that follows the user's answer**.\n\n**If the check is `[PASS]`** (or was not required — single sentence inline):\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) on \u003Ctarget> · Check ✅\n✅ [Rewrite applied]\n---\n```\n\n**If the check stays `[FAIL]` after 2 passes**:\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) on \u003Ctarget> · Check ❌\n⚠️ [Rewrite partial] — \u003Csummary of the last [FAIL]> · left untouched: \u003Cpassages>\n---\n```\n\n**If the user declines the rewrites**:\n```\n---\n✍️ Rewrite — 🚫 [Rewrite not applied — declined by the user]\n---\n```\n\n**In direct mode**, the only block, closing the single message that carries the rewritten text:\n```\n---\n✍️ Rewrite — \u003Cn> rewrite(s) applied directly · Check \u003C✅ | ❌>\n---\n```\nWith a check in `[FAIL]` after 2 passes, add `· left untouched: \u003Cpassages>` on the same line.\n\nIn the awaiting form, the two applied forms and the direct form, add before the final `---` one line per detected shift:\n`↪ Responsibility shift — \u003Crule>: \u003Cactor now named, or now hidden>`\n\nThis block appears only when this skill has actually run: its absence directly signals that no diagnosis took place. Other skills (`vibe:usage-report`, `vibe:debrief`) may add their own block after this one.\n",{},"main","0c226fd01e28e24c34766470e441e4efd4277884","skills\u002Frewrite","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe","https:\u002F\u002Fgithub.com\u002Fneolao","https:\u002F\u002Fneolao.com","Fullstack developer","2026-11-13 00:19:16",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add neolao\u002Fclaude-plugin-vibe --skill rewrite",{"tool":36,"command":37},"bunx","bunx skills add neolao\u002Fclaude-plugin-vibe --skill rewrite",{"tool":39,"command":40},"pnpm","pnpm dlx skills add neolao\u002Fclaude-plugin-vibe --skill rewrite","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frewrite\u002FSKILL.md",true,[44,50,54,58],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"references\u002Fcode-comments.md","REFERENCE","参考文档",12719,"https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frewrite\u002Freferences\u002Fcode-comments.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fcontrol.md",2676,"https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frewrite\u002Freferences\u002Fcontrol.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fdocument.md",6850,"https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frewrite\u002Freferences\u002Fdocument.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fsentence.md",31536,"https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frewrite\u002Freferences\u002Fsentence.md",[63,70,77,84,91,98],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":17},"01M787J4AMQXRM16BMVK98TYND","workspace-init","Set up or refresh a multi-repo workspace from the parent folder of its sibling repos — the hub repo (repos registry, cross-repo backlog and decisions) that \u002Fvibe:next-task reads, and the local, untracked workspace-root CLAUDE.md that indexes the hub and the siblings","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Fworkspace-init\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":17},"01M787J00GMM26BJ88M38T1FE4","usage-report","Usage report of a vibe workflow: counts, while the work runs, the bricks called, the loop rounds, the findings, the questions asked to the user and the fixes, then writes these statistics to `.vibe\u002Fusage-reports\u002F` in the project at the end. Invoked by `vibe:feature` and `vibe:fix` through their shared workflow, at the start of the work and at the end. Never triggered by a user request.","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Fusage-report\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":17},"01M787HTE89T0KDRHRQJ06TFKS","tasks","Creates and tracks a vibe workflow's task list and keeps it up to date until the end — through the native task system (TaskCreate \u002F TaskUpdate \u002F TaskList \u002F TaskGet) when it is available, otherwise through a `tasks.tsv` file in the scratchpad, kept by a script that reproduces the same model (ids, statuses, blockedBy dependencies, owner). Invoked internally by other vibe skills, never directly by users.","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Ftasks\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":17},"01M787HQPZHQZT9CGPRT1QM3V7","sync","Sync .vibe\u002F — generate on first run, incrementally update on subsequent runs","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Fsync\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":17},"01M787HH252DZHDHJF70DYAQ7A","review","Runs the project's active review agents on a scope and returns their raw findings — one owner per dimension, the shared finding contract injected into every prompt — without judging, fixing or committing anything. Invoked by the build workflow (`vibe:feature`, `vibe:fix`) as its internal review step and by `vibe:audit`, never directly by users.","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Freview\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":17},"01M787HD4F6Y7ESC3PHJAJHK04","release","Create a versioned release — bump version, finalize CHANGELOG.md, commit and tag","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frelease\u002FSKILL.md",[],[]]