Skip to content
Skills Library
Documents & office · Writing

dester-docs

/dester-docs

Create client-ready documentation and visual aids for a system that had none: system overview, module map, role and permission matrix, flow diagrams, data and status diagrams, test coverage summary, and a QA summary. Uses Mermaid diagrams, tables and annotated screenshots; can export to a Doc, HTML page, slides or PDF through the tools available. Use when the user says /dester-docs, 'make documentation', 'diagram this', 'visual for the client', 'system overview', 'flowchart', or after dester-explore or dester-cases.

Licence
MIT
Last repository change
29.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 29.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Create client-ready documentation and visual aids for a system that had none: system overview, module map, role and permission matrix, flow diagrams, data and status diagrams, test coverage summary, and a QA summary. Uses Mermaid diagrams, tables and annotated screenshots; can export to a Doc, HTML page, slides or PDF through the tools available. Use when the user says /dester-docs, 'make documentation', 'diagram this', 'visual for the client', 'system overview', 'flowchart', or after dester-explore or dester-cases.

Triggers from the description

make documentationdiagram thisvisual for the clientsystem overviewflowchart
Original author description

Create client-ready documentation and visual aids for a system that had none: system overview, module map, role and permission matrix, flow diagrams, data and status diagrams, test coverage summary, and a QA summary. Uses Mermaid diagrams, tables and annotated screenshots; can export to a Doc, HTML page, slides or PDF through the tools available. Use when the user says /dester-docs, 'make documentation', 'diagram this', 'visual for the client', 'system overview', 'flowchart', or after dester-explore or dester-cases.

How it works

  1. Inputs (ask, with defaults)
  2. Sources and honesty
  3. Visuals (Mermaid first; it renders in GitHub, most docs tools and HTML)
  4. Client-safe checklist (before anything leaves the project folder)
  5. Files
  6. Self-check before handing over
  7. Hand-off
Original SKILL.md headings · 82 lines, 669 words
SKILL.md preview
---
name: dester-docs
description: "Create client-ready documentation and visual aids for a system that had none: system overview, module map, role and permission matrix, flow diagrams, data and status diagrams, test coverage summary, and a QA summary. Uses Mermaid diagrams, tables and annotated screenshots; can export to a Doc, HTML page, slides or PDF through the tools available. Use when the user says /dester-docs, 'make documentation', 'diagram this', 'visual for the client', 'system overview', 'flowchart', or after dester-explore or dester-cases."
metadata:
  author: Destine April
  version: 0.1.0
  license: MIT
  suite: dester
---

# dester-docs v0.1.0

Author: Destine April. Read `references/core-rules.md` first; those rules win.

**What it does:** turns the project folder (map, derived spec, cases, session notes) into documents and visuals that
a client, boss or teammate can read without knowing QA.

Nothing is sent or shared without a yes for that exact action. Everything is a **DRAFT** until the user approves.

## Inputs (ask, with defaults)

1. **Who reads it?** Client owner, developers, end users, your own team. *Default: client owner, non-technical.*
2. **Which deliverables?** Pick any (default: 1, 2, 3, 4):
   1. System overview (what it is, modules, roles, in plain words)
   2. Role and permission matrix (who can do what)
   3. Flow diagrams (the main business flows, step by step, by role)
   4. Data and status diagrams (objects and how their status changes)
   5. Test coverage summary (what was tested, what was not, results)
   6. QA summary with findings and a recommendation (needs `dester-report` data)
   7. Quick user guide with annotated screenshots
3. **Format:** Markdown (default), an editable Doc, an HTML page, slides, or PDF/Word through whichever skill or
   connector is available. Say which was used.
4. **Tone:** plain and short; or formal for a contract deliverable.

## Sources and honesty

- Use `01_MAP.md`, `02_DERIVED_SPEC.md`, `05_TEST_CASES.md`, `04_SESSIONS/`, and evidence. If missing, offer
  `dester-explore` or `dester-cases` first.
- Every statement keeps its confidence from the spec. In client documents show it plainly as a legend:
  **Confirmed**, **Observed** (seen working, not yet confirmed by you), **Unclear** (needs your answer). Never turn a
  Hypothesis or Observed rule into a statement of fact.
- Unknowns go in a "Questions for you" section, not into guesses.
- Test results: counts come from the run log; recount before writing. Never claim a check that was not run.

## Visuals (Mermaid first; it renders in GitHub, most docs tools and HTML)

Use the templates in `references/diagram-templates.md`:
- **Flow:** `flowchart` with swimlanes per role (`subgraph`), one flow per diagram, max about 12 steps.
- **Roles matrix:** a table with colored words (`Allowed`, `View only`, `Denied`, `Not tested`), never color alone.
- **Status lifecycle:** `stateDiagram-v2` per data object.
- **Module map:** `flowchart LR` showing how data moves between modules.
- **Sequence:** `sequenceDiagram` for a flow that crosses systems (payment, email, SMS).
- **Coverage:** a table (area, cases, run, pass, bug, blocked), plus a simple bar if the format supports charts.
Each diagram has a one-line caption saying what to notice. Keep text labels short; check that the diagram has no
step that was never seen (unseen steps are drawn dashed and labelled `unconfirmed`).

If the user wants a polished page, build it with the artifact or doc tools available, following their design
guidance. A screenshot with boxes and numbers (annotated) is better than a long description: only use screenshots
that are redacted (see below).

## Client-safe checklist (before anything leaves the project folder)

- No passwords, tokens, API keys, session data. No real personal data (names, emails, phone numbers, faces).
- Screenshots show only fictional or masked data; staging URLs are fine to show only if the client agrees.
- Internal notes, guesses and raw bug drafts are not included. Security findings are never put in a
  general client document; they go to the owner only, through `dester-secure` and `dester-report`.
- No em dashes, plain language, consistent names for modules and roles (same as in the map).

## Files

```
06_DOCS/overview.md
06_DOCS/roles-matrix.md
06_DOCS/flows.md            (Mermaid blocks)
06_DOCS/data-status.md
06_DOCS/coverage.md
06_DOCS/user-guide.md       (if chosen)
06_DOCS/exports/            (HTML, PDF, DOCX when produced)
```

## Self-check before handing over

- Every diagram step and matrix cell traces to a spec row or session note; unconfirmed ones are marked.
- Names match the map. Numbers recounted. Legend present. Client-safe checklist passed (list what you checked).
- The file exists and is non-empty (`test -s`) for every file you claim.

## Hand-off

Show what was produced, what is unconfirmed (first), and the questions for the owner. Ask for approval before any
export or share. Exporting to a Doc, Drive, email or chat is a separate yes.
Files in this package (4)
  • SKILL.md 5 KB
  • references/core-rules.md 3 KB
  • references/diagram-templates.md 1 KB
  • references/glossary.md 2 KB

Versions

The database has no other skills named dester-docs.

Database snapshot: 13.11.2026 · package version 70fca4024f2a (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100dester-cases
    Write test cases for a system, feature or screen from a derived spec, an exploration map, a link you can open, or a repo. Newbie-friendly, plain language. Produces cases in five categories (happy path, positive, negative, edge, boundary) with traceability to a requirement or…
  • 100dester-discover
    Step 0 of a QA project: create a Discovery Pack for the client to fill in (what the system is, who uses it, how we get access, what must work, what is out of bounds, plus platform-specific asks for Lovable, GoHighLevel, Azure, GitHub, Claude Code or Codex projects), then read…
  • 100docs-diagrams
    Convert existing docs diagram images to Mermaid, and author new Mermaid diagrams for Mastra docs. Use when replacing an Excalidraw or PNG/JPG/SVG diagram with Mermaid, when a docs page needs a new diagram, when a diagram renders wrong in light or dark mode, or when auditing…
  • 91diagrams
    Use when drawing a page under Documentation/Diagram. Source and sibling.
  • 100mermaid-diagram-builder
    Creates clear, valid, version-controllable diagrams as code using Mermaid — flowcharts, sequence diagrams, ER diagrams, class diagrams, state machines, Gantt charts, C4/architecture diagrams, and more. Use this skill when the user asks to "draw a diagram", "make a flowchart",…
  • 100presentation-diagrams
    Use when a presentation needs architecture diagrams, flowcharts, sequence diagrams, or system visuals — tagged [DIAGRAM] slides from narrative, "add a visual of how X connects to Y", or any system overview visualization for slides. Part of the presentation-* skill family.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.