cratis-documentation-writing SKILL.md skillA
cratis-documentation-writing from cratis/ai is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add cratis/ai/cratis-documentation-writing@git:20261003.a58d382Pins git:20261003.a58d382 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- cratis/ai
- Path
.cratis/ai/skills/cratis-documentation-writing/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261003.a58d382, committed Oct 3, 2026
- First version recorded
- Sep 29, 2026
- Size
- 12,704 bytes
- Repository stars
- 4
- License
- MIT
Plan, write, and improve user-centered Cratis documentation with a clear reader journey and one primary Diátaxis purpose per page. Use for product docs, tutorials, how-to guides, reference, explanations, and documentation reviews. For executable examples use cratis-technical-examples; for release notes use cratis-release-notes. Do not invent APIs or publish content.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Documentation writing A developer arrives with a job to do, not with an interest in our repository structure. Start from that job: what did they try, what stopped them, and what would let them know they succeeded? Use [Diátaxis](https://diataxis.fr/) as a compass for each page's primary purpose, not a purity test. This skill governs content and reader journeys; the owning repository governs page placement, navigation, and rendering. ## Classify before writing Determine which quadrant the page belongs to before drafting: | Type | Orientation | Analogy | When to use | | --- | --- | --- | --- | | **Tutorial** | Learning | A lesson | Guide a newcomer step-by-step to a successful first outcome | | **How-to guide** | Problem-solving | A recipe | Show an experienced user how to accomplish a specific task | | **Reference** | Information | A dictionary | Describe the technical machinery — APIs, attributes, configuration | | **Explanation** | Understanding | A discussion | Clarify *why* something works the way it does, trade-offs, architecture | Rules per type: - **Tutorial** — lead a newcomer through one realistic, threaded outcome. …
Read the whole file at its exact version.
How to install
mdr add cratis/ai/cratis-documentation-writing@sha256:0d925576bace963cThe line at the top of this page pins the label git:20261003.a58d382, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_oss7ix2mlwxmwzp5)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Sep 29, 2026 and Oct 3, 2026, more than one a day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261003.a58d382 latest | 2026-10-03 | a58d382 | 12,704 B | A | view · diff |
| git:20260929.01b92cf | 2026-09-29 | 01b92cf | 12,323 B | A | view · diff |
| git:20260929.224c7e8 | 2026-09-29 | 224c7e8 | 12,315 B | A | view · diff |
| git:20260929.d2a00c8 | 2026-09-29 | d2a00c8 | 12,277 B | A | view · diff |
| git:20260929.c481f65 | 2026-09-29 | c481f65 | 12,265 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (12704 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
cratis/ai · 4 stars · license MIT · pushed 2026-11-04 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_oss7ix2mlwxmwzp5 GET https://markdownregistry.com/api/v1/resolve?ref=cratis/ai/cratis-documentation-writing GET https://markdownregistry.com/api/v1/blob/0d925576bace963cf1970a2a6a9c9b5203414258cb67d5cda7ed8df48757ae80
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.