[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EHDKXFJAXFDAF494KW6R0N":3,"skill-same:01M7EHDKXFJAXFDAF494KW6R0N":45},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7EHDKXFJAXFDAF494KW6R0N","diagrams",null,"diagrams, the rules for every Mermaid diagram. Use whenever you explain in chat how code, a set of files or a feature works, even when the user only asks what the files do. Also use when a flow, a process, a lifecycle, a data model, a type hierarchy or an architecture is explained in documentation, when the user plans a change to one, when an issue or a pull request changes one, when a code change touches a file a diagram links, or when the user names the diagrams skill.","renefatuaki\u002Fskills","renefatuaki","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F43519979?v=4","01M7EHD24GFMFZRH3Z04WSYC9A","René","01M7EHD25408DH8QKN61CSDXX4",0,"MIT","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fdiagrams\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: diagrams\ndescription: diagrams, the rules for every Mermaid diagram. Use whenever you explain in chat how code, a set of files or a feature works, even when the user only asks what the files do. Also use when a flow, a process, a lifecycle, a data model, a type hierarchy or an architecture is explained in documentation, when the user plans a change to one, when an issue or a pull request changes one, when a code change touches a file a diagram links, or when the user names the diagrams skill.\n---\n\nRules for every diagram you draw or touch. A diagram answers one question about a flow or a structure faster than the code or a page of prose does. It is a `mermaid` code block in Markdown. The text is the only source, so a person reads the picture and an agent reads the block. GitHub, VS Code and JetBrains render it without a build step.\n\n## Steps\n\n1. **Decide whether a diagram helps.** A flow or a structure you explain is a diagram. A single step or a single relation, such as one function that calls another, has nothing to connect and stays a sentence. The steps a reader follows in a how-to stay a numbered list. Values the reader looks up stay a table. When you explain a flow or a structure in chat, draw it without being asked.\n2. **Name the question.** One diagram answers one question, written as one sentence in the language of the surrounding document, or of the conversation in chat. A second question is a second diagram.\n3. **Pick the type.** Take it from [Types](#types) by the question. Another type only when the user asks for it.\n4. **Read the code.** Every element of a diagram of the current state exists in the code. Every edge is a call, a transition or a relation you read there. What you did not read is left out, never guessed. A diagram of something that is not built yet is a [planned state](#planned-state).\n5. **Draw.** Every line follows [Form](#form). A diagram the reader cannot take in at a glance is split. The overview keeps the main path and folds each group of steps into one element. Every folded group gets a diagram of its own.\n6. **Explain and link.** Add the [terms and the example](#terms-and-example) and the table of [Sources](#sources).\n7. **Place it.** The file follows the `project-docs` skill. An existing structure of the project wins.\n   - A diagram of the whole project, such as its architecture, its data model or a process across features, lives in `docs\u002F\u003Ctopic>.md`.\n   - A diagram of one flow or one feature lives in the `README.md` of the folder that holds its code, such as `src\u002Forders\u002FREADME.md`. GitHub shows that file when the reader opens the folder.\n   - Code that has no folder of its own sends the diagram to `docs\u002F\u003Ctopic>.md`.\n   - A detail diagram lives in the `README.md` of the subfolder it describes. The overview links it from its table.\n   - A folder that needs more than one diagram keeps the overview in its `README.md`. Every detail diagram without a subfolder of its own gets a file in the `docs\u002F` folder next to the code, one diagram per file and named after what it shows, such as `src\u002Fextraction\u002Fpdf\u002Fdocs\u002Fbyte-checks.md`. The overview links each file from its table.\n8. **Show it.** A terminal prints a `mermaid` block as text. Write every diagram you show in chat into `$TMPDIR\u002Fdiagrams\u002F\u003Ctopic>.md` as well, outside the repository, and name the path. The user opens it in the Markdown preview of the IDE.\n\nDone when every diagram names its one question, takes the type of that question, shows only what the code holds, links each element to its source, sits where the reader looks for it, parses without an error, and a reader understands it without opening the code.\n\n## Types\n\n| The reader asks | Type | Instead |\n| --- | --- | --- |\n| What happens in which order, and where does it branch? | `flowchart` | |\n| Who is responsible for which step? | `flowchart` with one `subgraph` per role | `sequenceDiagram` when the messages matter more than the work |\n| Who talks to whom, and when? | `sequenceDiagram` | |\n| Which states does it pass through? | `stateDiagram-v2` | `flowchart` when the nodes are actions |\n| How does the data relate? | `erDiagram` | `classDiagram` when behaviour or inheritance matters |\n| How do the types relate? | `classDiagram` | `flowchart` for plain dependencies between modules |\n| What is the system made of? | `architecture-beta` | |\n| When does what happen? | `timeline`, `gantt` for durations, `gitGraph` for branches | A list, unless time is the question |\n| How is it divided? | `mindmap` | `flowchart` once the parts link across |\n\nThe same question takes the same type inside the code, around it and in the domain. A control flow, a CI pipeline and an order process are all a `flowchart`.\n\n`architecture-beta` is a beta type of Mermaid. Its icons are `cloud`, `database`, `disk`, `internet` and `server`, and it takes no `classDef`.\n\n## Form\n\n- The first line after the keyword is `accTitle`, followed by the question of step 2. A type that knows no `accTitle`, such as `mindmap`, `sankey-beta` and `block-beta`, takes the question as `title` in its front matter.\n- An ID is the name the element has in the code, in lowerCamelCase, such as `checkOrder`. Never a single letter and never `end`.\n- A label says what happens in the words of the domain, a step with its verb first, such as `\"Charge the payment\"`, never the operator or the call in the code, such as `\"amount > limit\"`. It stands in double quotes and in the language of the surrounding document.\n- Every branch of a decision carries its condition as the label of its edge. An edge that ends the flow early also names the reason, unless the condition already explains it. An error or a log code follows in parentheses, such as `-->|\"over 20 MB, the parser holds the whole file in memory (file_too_large)\"|`.\n- A `flowchart` runs `TD`. A pipeline without a branch runs `LR`.\n- Declare the elements in reading order, so the edges cross as little as possible.\n- A comment is `%%` on a line of its own.\n- Meaning stands in the text. A colour or a shape alone never carries it.\n- A `flowchart`, a `stateDiagram-v2` and a `classDiagram` carry the line `%%{init: {\"htmlLabels\": false}}%%` right before the keyword, after the front matter when there is one. Without it Mermaid draws each label as HTML in a box it measured at 100 % zoom, and Safari and Chrome cut the text off at any other zoom. With it every label is SVG text that wraps inside its shape. The other types draw SVG text on their own.\n- Only the syntax of the Mermaid version that [Mermaid](#mermaid) names. No `click`, no icon, no other `%%{init}%%`, no `config` in the front matter and no ELK layout. Every renderer applies its own theme and layout, so nothing depends on where an element lands.\n\n## Sources\n\nThe table stands right under the diagram, with only a blank line between them. It has one row per element that exists in the code, a node, a participant, a state, an entity, a class or a service. The first cell is the ID as the diagram writes it. The second cell is a relative link to the file, with the symbol as its text. An element that folds a group links the file that holds its detail diagram, a `README.md` or a file under `docs\u002F`.\n\n````markdown\n```mermaid\n%%{init: {\"htmlLabels\": false}}%%\nflowchart TD\n  accTitle: How does an order get from the cart to the warehouse?\n  checkOrder[\"Check the order\"] --> chargePayment{\"Charge the payment\"}\n  chargePayment -->|paid| shipOrder[\"Ship the order\"]\n  chargePayment -->|declined| rejectOrder[\"Reject the order\"]\n```\n\n| Element | Source |\n| --- | --- |\n| `checkOrder` | [`checkOrder`](checkout.ts) |\n| `chargePayment` | [`chargePayment`](payment.ts) |\n| `shipOrder` | [`shipOrder`](checkout.ts) |\n| `rejectOrder` | [`rejectOrder`](checkout.ts) |\n````\n\n`timeline`, `gantt`, `gitGraph`, `journey` and `mindmap` take no table, because no file stands behind their elements.\n\n## Terms and example\n\n- Every term the reader needs, of the domain or of the code, is explained once, in a table with the columns `Term` and `Meaning` above the diagram. The diagrams of one folder share the table in its `README.md`.\n- A flow that computes a value or checks a limit gets a worked example under the table of sources. It runs one input through the flow with real values from the repository, such as the limit its configuration sets, and names the edge each step takes.\n\n## Planned state\n\nA planned state is a sketch of something that is not built yet, or the effect of a change the user considers. It helps the user decide before the code changes.\n\n- It goes into the chat, as step 8 shows it, and into the issue or the pull request that carries the change, as the `issue` and `pull-request` skills place it. The documentation shows what exists. A planned state enters it only on the user's word, under a `> [!NOTE]` that calls it a draft.\n- It takes no table of sources, because its new elements have no file yet.\n- A change is one diagram of the future state. Every element the change touches takes one of the classes `added`, `changed` and `removed`. A removed element stays in the diagram, and the edges to it are dotted. The three `classDef` lines close the diagram as written below.\n- Under the diagram stands the legend as one sentence, then one bullet per consequence, such as a caller, a table, a test or a document the change also touches.\n- Only the four types of the table below take a `classDef`. In every other type, such as `sequenceDiagram` and `architecture-beta`, the change is two diagrams, the current state under **Before** and the future state under **After**.\n\n````markdown\n```mermaid\n%%{init: {\"htmlLabels\": false}}%%\nflowchart TD\n  accTitle: How does an order run once the fraud check exists?\n  checkOrder[\"Check the order\"] --> chargePayment{\"Charge the payment\"}\n  chargePayment -->|paid| checkFraud[\"Check for fraud\"]:::added\n  checkFraud --> shipOrder[\"Ship the order\"]:::changed\n  chargePayment -.->|paid| shipDirectly[\"Ship without a check\"]:::removed\n  chargePayment -->|declined| rejectOrder[\"Reject the order\"]\n\n  classDef added fill:#d1f0d9,stroke:#1a7f37,color:#000,stroke-width:3px\n  classDef changed fill:#fff3c4,stroke:#9a6700,color:#000,stroke-dasharray:6 3\n  classDef removed fill:#eee,stroke:#888,color:#555,stroke-dasharray:2 2\n```\n\nA thick border is added, a dashed border is changed, a dotted grey border is removed.\n\n- `shipOrder` waits for the fraud check, so an order ships later.\n- The tests of `checkout.ts` cover the direct path and need the new one.\n````\n\n| Type | An element takes a class as |\n| --- | --- |\n| `flowchart` | `checkFraud[\"Check for fraud\"]:::added` |\n| `stateDiagram-v2` | `class Checked added` |\n| `classDiagram` | `class FraudCheck:::added` |\n| `erDiagram` | `FRAUD_CHECK:::added` |\n\n## Update\n\nA diagram in the repository is true for the current code. Bring it up to date when the user asks, when the hook reports `path:line linked` at the end of a turn, and when the `pull-request` skill asks for the files of a branch.\n\n1. **Find the diagrams.** The hook names the ones in a `README.md` above the changed file and in a `docs\u002F` folder beside one of those. For a diagram anywhere else, and without the hook, search the Markdown files for links to each changed file with `grep -rn --include='*.md' -F '\u003Cfile name>' .` and keep the hits that stand in a table under a `mermaid` block.\n2. **Read the code again**, as step 4 of [Steps](#steps) does.\n3. **Change what differs**, in the diagram and in its table. An element whose file is gone leaves both.\n4. **Report.** Show the old and the new block as a diff. A diagram that still holds is named as unchanged.\n\n## Mermaid\n\nGitHub, VS Code and JetBrains each ship their own Mermaid, and the oldest of the three decides what a diagram may use. That version is 11.15.0. The hook checks the syntax with the Mermaid of the project, so the project pins exactly that version. If a project with a `package.json` has no `mermaid`, install it after confirmation with the \"Add dev dependency\" command of the `package-manager` skill.\n\n```sh\npnpm add -D --save-exact mermaid@11.15.0\n```\n\n- [Mermaid syntax reference](https:\u002F\u002Fraw.githubusercontent.com\u002Fmermaid-js\u002Fmermaid\u002Fdevelop\u002Fdocs\u002Fintro\u002Fsyntax-reference.md)\n- [Mermaid accessibility options](https:\u002F\u002Fraw.githubusercontent.com\u002Fmermaid-js\u002Fmermaid\u002Fdevelop\u002Fdocs\u002Fconfig\u002Faccessibility.md)\n- [GitHub, creating diagrams](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fget-started\u002Fwriting-on-github\u002Fworking-with-advanced-formatting\u002Fcreating-diagrams.md)\n\n## Hook feedback\n\nWhen a turn ends, a Stop hook parses every `mermaid` block of a Markdown file the turn changed with the Mermaid of the project. When it reports `path:line syntax` with the message of the parser, fix each reported line, then end the turn. A project without Mermaid gets no syntax check. The hook also reports `path:line html-labels` for a `flowchart`, a `stateDiagram-v2` or a `classDiagram` without the init line of [Form](#form), with or without Mermaid in the project. Add the line, then end the turn. For any file the turn changed, however it changed, the hook reports `path:line linked` and the changed files for each diagram whose table links one of them. A diagram whose own file the turn changed is not named. Run [Update](#update) on each of them. In a project that has Mermaid, silence means every diagram parses. The rules above still apply.\n","Rules for every diagram you draw or touch. A diagram answers one question about a flow or a structure faster than the code or a page of prose does. It is a `mermaid` code block in Markdown. The text is the only source, so a person reads the picture and an agent reads the block. GitHub, VS Code and JetBrains render it without a build step.\n\n## Steps\n\n1. **Decide whether a diagram helps.** A flow or a structure you explain is a diagram. A single step or a single relation, such as one function that calls another, has nothing to connect and stays a sentence. The steps a reader follows in a how-to stay a numbered list. Values the reader looks up stay a table. When you explain a flow or a structure in chat, draw it without being asked.\n2. **Name the question.** One diagram answers one question, written as one sentence in the language of the surrounding document, or of the conversation in chat. A second question is a second diagram.\n3. **Pick the type.** Take it from [Types](#types) by the question. Another type only when the user asks for it.\n4. **Read the code.** Every element of a diagram of the current state exists in the code. Every edge is a call, a transition or a relation you read there. What you did not read is left out, never guessed. A diagram of something that is not built yet is a [planned state](#planned-state).\n5. **Draw.** Every line follows [Form](#form). A diagram the reader cannot take in at a glance is split. The overview keeps the main path and folds each group of steps into one element. Every folded group gets a diagram of its own.\n6. **Explain and link.** Add the [terms and the example](#terms-and-example) and the table of [Sources](#sources).\n7. **Place it.** The file follows the `project-docs` skill. An existing structure of the project wins.\n   - A diagram of the whole project, such as its architecture, its data model or a process across features, lives in `docs\u002F\u003Ctopic>.md`.\n   - A diagram of one flow or one feature lives in the `README.md` of the folder that holds its code, such as `src\u002Forders\u002FREADME.md`. GitHub shows that file when the reader opens the folder.\n   - Code that has no folder of its own sends the diagram to `docs\u002F\u003Ctopic>.md`.\n   - A detail diagram lives in the `README.md` of the subfolder it describes. The overview links it from its table.\n   - A folder that needs more than one diagram keeps the overview in its `README.md`. Every detail diagram without a subfolder of its own gets a file in the `docs\u002F` folder next to the code, one diagram per file and named after what it shows, such as `src\u002Fextraction\u002Fpdf\u002Fdocs\u002Fbyte-checks.md`. The overview links each file from its table.\n8. **Show it.** A terminal prints a `mermaid` block as text. Write every diagram you show in chat into `$TMPDIR\u002Fdiagrams\u002F\u003Ctopic>.md` as well, outside the repository, and name the path. The user opens it in the Markdown preview of the IDE.\n\nDone when every diagram names its one question, takes the type of that question, shows only what the code holds, links each element to its source, sits where the reader looks for it, parses without an error, and a reader understands it without opening the code.\n\n## Types\n\n| The reader asks | Type | Instead |\n| --- | --- | --- |\n| What happens in which order, and where does it branch? | `flowchart` | |\n| Who is responsible for which step? | `flowchart` with one `subgraph` per role | `sequenceDiagram` when the messages matter more than the work |\n| Who talks to whom, and when? | `sequenceDiagram` | |\n| Which states does it pass through? | `stateDiagram-v2` | `flowchart` when the nodes are actions |\n| How does the data relate? | `erDiagram` | `classDiagram` when behaviour or inheritance matters |\n| How do the types relate? | `classDiagram` | `flowchart` for plain dependencies between modules |\n| What is the system made of? | `architecture-beta` | |\n| When does what happen? | `timeline`, `gantt` for durations, `gitGraph` for branches | A list, unless time is the question |\n| How is it divided? | `mindmap` | `flowchart` once the parts link across |\n\nThe same question takes the same type inside the code, around it and in the domain. A control flow, a CI pipeline and an order process are all a `flowchart`.\n\n`architecture-beta` is a beta type of Mermaid. Its icons are `cloud`, `database`, `disk`, `internet` and `server`, and it takes no `classDef`.\n\n## Form\n\n- The first line after the keyword is `accTitle`, followed by the question of step 2. A type that knows no `accTitle`, such as `mindmap`, `sankey-beta` and `block-beta`, takes the question as `title` in its front matter.\n- An ID is the name the element has in the code, in lowerCamelCase, such as `checkOrder`. Never a single letter and never `end`.\n- A label says what happens in the words of the domain, a step with its verb first, such as `\"Charge the payment\"`, never the operator or the call in the code, such as `\"amount > limit\"`. It stands in double quotes and in the language of the surrounding document.\n- Every branch of a decision carries its condition as the label of its edge. An edge that ends the flow early also names the reason, unless the condition already explains it. An error or a log code follows in parentheses, such as `-->|\"over 20 MB, the parser holds the whole file in memory (file_too_large)\"|`.\n- A `flowchart` runs `TD`. A pipeline without a branch runs `LR`.\n- Declare the elements in reading order, so the edges cross as little as possible.\n- A comment is `%%` on a line of its own.\n- Meaning stands in the text. A colour or a shape alone never carries it.\n- A `flowchart`, a `stateDiagram-v2` and a `classDiagram` carry the line `%%{init: {\"htmlLabels\": false}}%%` right before the keyword, after the front matter when there is one. Without it Mermaid draws each label as HTML in a box it measured at 100 % zoom, and Safari and Chrome cut the text off at any other zoom. With it every label is SVG text that wraps inside its shape. The other types draw SVG text on their own.\n- Only the syntax of the Mermaid version that [Mermaid](#mermaid) names. No `click`, no icon, no other `%%{init}%%`, no `config` in the front matter and no ELK layout. Every renderer applies its own theme and layout, so nothing depends on where an element lands.\n\n## Sources\n\nThe table stands right under the diagram, with only a blank line between them. It has one row per element that exists in the code, a node, a participant, a state, an entity, a class or a service. The first cell is the ID as the diagram writes it. The second cell is a relative link to the file, with the symbol as its text. An element that folds a group links the file that holds its detail diagram, a `README.md` or a file under `docs\u002F`.\n\n````markdown\n```mermaid\n%%{init: {\"htmlLabels\": false}}%%\nflowchart TD\n  accTitle: How does an order get from the cart to the warehouse?\n  checkOrder[\"Check the order\"] --> chargePayment{\"Charge the payment\"}\n  chargePayment -->|paid| shipOrder[\"Ship the order\"]\n  chargePayment -->|declined| rejectOrder[\"Reject the order\"]\n```\n\n| Element | Source |\n| --- | --- |\n| `checkOrder` | [`checkOrder`](checkout.ts) |\n| `chargePayment` | [`chargePayment`](payment.ts) |\n| `shipOrder` | [`shipOrder`](checkout.ts) |\n| `rejectOrder` | [`rejectOrder`](checkout.ts) |\n````\n\n`timeline`, `gantt`, `gitGraph`, `journey` and `mindmap` take no table, because no file stands behind their elements.\n\n## Terms and example\n\n- Every term the reader needs, of the domain or of the code, is explained once, in a table with the columns `Term` and `Meaning` above the diagram. The diagrams of one folder share the table in its `README.md`.\n- A flow that computes a value or checks a limit gets a worked example under the table of sources. It runs one input through the flow with real values from the repository, such as the limit its configuration sets, and names the edge each step takes.\n\n## Planned state\n\nA planned state is a sketch of something that is not built yet, or the effect of a change the user considers. It helps the user decide before the code changes.\n\n- It goes into the chat, as step 8 shows it, and into the issue or the pull request that carries the change, as the `issue` and `pull-request` skills place it. The documentation shows what exists. A planned state enters it only on the user's word, under a `> [!NOTE]` that calls it a draft.\n- It takes no table of sources, because its new elements have no file yet.\n- A change is one diagram of the future state. Every element the change touches takes one of the classes `added`, `changed` and `removed`. A removed element stays in the diagram, and the edges to it are dotted. The three `classDef` lines close the diagram as written below.\n- Under the diagram stands the legend as one sentence, then one bullet per consequence, such as a caller, a table, a test or a document the change also touches.\n- Only the four types of the table below take a `classDef`. In every other type, such as `sequenceDiagram` and `architecture-beta`, the change is two diagrams, the current state under **Before** and the future state under **After**.\n\n````markdown\n```mermaid\n%%{init: {\"htmlLabels\": false}}%%\nflowchart TD\n  accTitle: How does an order run once the fraud check exists?\n  checkOrder[\"Check the order\"] --> chargePayment{\"Charge the payment\"}\n  chargePayment -->|paid| checkFraud[\"Check for fraud\"]:::added\n  checkFraud --> shipOrder[\"Ship the order\"]:::changed\n  chargePayment -.->|paid| shipDirectly[\"Ship without a check\"]:::removed\n  chargePayment -->|declined| rejectOrder[\"Reject the order\"]\n\n  classDef added fill:#d1f0d9,stroke:#1a7f37,color:#000,stroke-width:3px\n  classDef changed fill:#fff3c4,stroke:#9a6700,color:#000,stroke-dasharray:6 3\n  classDef removed fill:#eee,stroke:#888,color:#555,stroke-dasharray:2 2\n```\n\nA thick border is added, a dashed border is changed, a dotted grey border is removed.\n\n- `shipOrder` waits for the fraud check, so an order ships later.\n- The tests of `checkout.ts` cover the direct path and need the new one.\n````\n\n| Type | An element takes a class as |\n| --- | --- |\n| `flowchart` | `checkFraud[\"Check for fraud\"]:::added` |\n| `stateDiagram-v2` | `class Checked added` |\n| `classDiagram` | `class FraudCheck:::added` |\n| `erDiagram` | `FRAUD_CHECK:::added` |\n\n## Update\n\nA diagram in the repository is true for the current code. Bring it up to date when the user asks, when the hook reports `path:line linked` at the end of a turn, and when the `pull-request` skill asks for the files of a branch.\n\n1. **Find the diagrams.** The hook names the ones in a `README.md` above the changed file and in a `docs\u002F` folder beside one of those. For a diagram anywhere else, and without the hook, search the Markdown files for links to each changed file with `grep -rn --include='*.md' -F '\u003Cfile name>' .` and keep the hits that stand in a table under a `mermaid` block.\n2. **Read the code again**, as step 4 of [Steps](#steps) does.\n3. **Change what differs**, in the diagram and in its table. An element whose file is gone leaves both.\n4. **Report.** Show the old and the new block as a diff. A diagram that still holds is named as unchanged.\n\n## Mermaid\n\nGitHub, VS Code and JetBrains each ship their own Mermaid, and the oldest of the three decides what a diagram may use. That version is 11.15.0. The hook checks the syntax with the Mermaid of the project, so the project pins exactly that version. If a project with a `package.json` has no `mermaid`, install it after confirmation with the \"Add dev dependency\" command of the `package-manager` skill.\n\n```sh\npnpm add -D --save-exact mermaid@11.15.0\n```\n\n- [Mermaid syntax reference](https:\u002F\u002Fraw.githubusercontent.com\u002Fmermaid-js\u002Fmermaid\u002Fdevelop\u002Fdocs\u002Fintro\u002Fsyntax-reference.md)\n- [Mermaid accessibility options](https:\u002F\u002Fraw.githubusercontent.com\u002Fmermaid-js\u002Fmermaid\u002Fdevelop\u002Fdocs\u002Fconfig\u002Faccessibility.md)\n- [GitHub, creating diagrams](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fget-started\u002Fwriting-on-github\u002Fworking-with-advanced-formatting\u002Fcreating-diagrams.md)\n\n## Hook feedback\n\nWhen a turn ends, a Stop hook parses every `mermaid` block of a Markdown file the turn changed with the Mermaid of the project. When it reports `path:line syntax` with the message of the parser, fix each reported line, then end the turn. A project without Mermaid gets no syntax check. The hook also reports `path:line html-labels` for a `flowchart`, a `stateDiagram-v2` or a `classDiagram` without the init line of [Form](#form), with or without Mermaid in the project. Add the line, then end the turn. For any file the turn changed, however it changed, the hook reports `path:line linked` and the changed files for each diagram whose table links one of them. A diagram whose own file the turn changed is not named. Run [Update](#update) on each of them. In a project that has Mermaid, silence means every diagram parses. The rules above still apply.\n",{"name":5,"description":7},"main","95608c3222b36a55dba667cf51a92a2efdf5e65c","skills\u002Fdocs\u002Fdiagrams","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills","https:\u002F\u002Fgithub.com\u002Frenefatuaki","Senior Software Engineer","2026-11-11 02:18:10",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add renefatuaki\u002Fskills --skill diagrams",{"tool":37,"command":38},"bunx","bunx skills add renefatuaki\u002Fskills --skill diagrams",{"tool":40,"command":41},"pnpm","pnpm dlx skills add renefatuaki\u002Fskills --skill diagrams","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fdiagrams\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7EHM6WHPXSSEDBK04TSGYW3","why","Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior.","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7EHM3Z7JM36BCPJAQBVAMJ1","tdd","Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious cheap local test target. Skip when the test path is unclear, expensive, integration-heavy, or not requested.","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Ftdd\u002FSKILL.md",[],[],{"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},"01M7EHM0WJND99F23YC24X0PXS","swarm","Fan out N parallel workers, drain them, and return one report. Use for \u002Fswarm, 'swarm this', or parallel coverage, races, gauntlets, and exploration.","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fswarm\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},"01M7EHKXJPJHD57W7S0V2FYAAM","show-me-your-work","Keep a reviewable decision trail for long-running or unattended work: a TSV log with one row per decision (what, why, evidence, result). Local by default; commit it when a reviewer needs the trail to trust the result. Use for \u002Fshow-me-your-work, autonomous or multi-phase runs, or work a human reviews after stepping away.","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fshow-me-your-work\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},"01M7EHKSX411XWSR4GYZ9VKP42","interrogate","Use for \"interrogate\", \"adversarial review\", \"multi-model review\", \"challenge this\", \"stress test this code\", \"find blind spots\", or \"tear this apart\". Multiple LLM reviewers challenge changes from independent angles.","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Finterrogate\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},"01M7EHKPW39MGDZHA95BKXK5NJ","how","Use for \"how does X work\", code walkthroughs before changing something, and placement \u002F ownership \u002F layering questions (\"where should this live\", \"which package owns this\", \"is this the right layer\"). Explains subsystem architecture, runtime flow, onboarding mental models. Use why for motivation.","https:\u002F\u002Fgithub.com\u002Frenefatuaki\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhow\u002FSKILL.md",[],[]]