メニュー
Authoring docs in ppds-docs — Diátaxis classification, voice, style. Use when writing or restructuring tutorials, guides, reference, or concept docs.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Authoring blog posts in ppds-docs — first-person voice, technical narrative. Use when drafting a blog post or release recap.
Run manifest-driven PNG captures of the ppds-docs site (Docusaurus) for design audits. Emits a schema-conformant capture tree for consumption by a Claude design-audit session. Captures each page in both light and dark themes.
Playwright Chromium harness for capturing Docusaurus pages and components in light + dark themes. Use directly when iterating on a single page, or via audit-capture for a full manifest-driven run.
| name | write-docs |
| description | Authoring docs in ppds-docs — Diátaxis classification, voice, style. Use when writing or restructuring tutorials, guides, reference, or concept docs. |
Conventions for the documentation site. Triggers when authoring or
reorganizing prose under docs/.
docs/Every doc fits exactly one of these buckets. If you cannot pick one, the doc needs to be split.
| Type | Purpose | Voice |
|---|---|---|
| Tutorial | Learning-oriented, step-by-step | Hand-hold the reader through a complete experience |
| Guide | Task-oriented, goal-focused | Show the most direct path to the user's goal |
| Reference | Information-oriented, complete | Be exhaustive and predictable; no opinions |
| Concept | Understanding-oriented, explains why | Explain the model and tradeoffs; no procedure |
Mixing types in one page is the most common drift. A tutorial that becomes a reference table is two pages.
todo, no fix in prod, no untested
placeholders. If a value must be substituted, surface it with an
explicit callout immediately above the block.docs/<bucket>/<slug>.md with the right Diátaxis bucket.sidebars.ts if surfacing to users.npm start) and proof at
localhost:3000.Doc-authoring conventions only matter when writing prose. Loading them into every Claude session in the docs repo would crowd out genuinely global rules. The skill auto-loads when it is needed; otherwise it sits idle.