Create Clear Diátaxis Documentation
Software documentation often mixes learning, task, reference, and conceptual content. This skill separates those needs and produces focused Markdown for a defined audience.
This skill is part of a pack
Install the whole pack to get every skill the task needs, in one command.
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "documentation-writer" from https://skillstore.io/skills/github-documentation-writer.md and its manifest at https://skillstore.io/api/skills/github-documentation-writer/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Using "documentation-writer". Create a tutorial for developers installing a command-line tool for the first time.
Expected outcome:
Proposed outline: prerequisites, installation, first configuration, first successful command, verification, and next steps.
Using "documentation-writer". Write a how-to guide for rotating an expired service credential.
Expected outcome:
How to rotate an expired service credential: confirm the affected service, issue a replacement, update the configuration, restart safely, and verify access.
Using "documentation-writer". Explain why the platform uses asynchronous job processing.
Expected outcome:
Explanation structure: the workload problem, queue-based processing, reliability tradeoffs, operational effects, and situations where synchronous processing remains appropriate.
The skill contains prompt guidance for technical writing and no executable network operation. The Diátaxis website URL is a framework citation, not a request target or data transfer mechanism.
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
https://skillstore.io/skills/github-documentation-writer/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/github-documentation-writer?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/github-documentation-writer?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/github-documentation-writer/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/github-documentation-writer.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>github. (2026). documentation-writer security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/github-documentation-writer/audits/5@techreport{github-github-documentation-writer-2026,
author = {github},
title = {documentation-writer security audit report (audit version 5)},
institution = {Skillstore},
year = {2026},
number = {5},
url = {https://skillstore.io/skills/github-documentation-writer/audits/5},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "documentation-writer security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
- name: "github"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/github-documentation-writer/audits/5"
identifiers:
- type: other
value: "skillstore:github-documentation-writer:audit:5"
description: "Skillstore immutable audit report identifier"
Each author remains a separate installable skill. The recommended variant is ranked by Skillstore evidence.
Why this variant is first
github-documentation-writer
2026-08-21
c0ntr0lledcha0s-documentation-writer
2026-08-21
Create a structured tutorial that leads new team members from setup to a successful first result.
Turn a recurring operational task into a focused how-to guide with clear scope and ordered steps.
Separate mixed source material into reference and explanation documents for easier maintenance and discovery.
Create a tutorial that teaches [audience] to achieve [goal]. Include [topics] and exclude [topics]. Ask necessary questions before proposing the outline.
Plan a how-to guide for [task] using these project details: [context]. Propose an outline and wait for approval before drafting.
Create reference documentation for [component]. Cover [interfaces, parameters, behaviors, and errors] for [audience], using [provided files] as style context.
Design a Diátaxis documentation set for [product]. Map [source material] into four document types, identify gaps, and propose linked outlines before drafting.
Author
githubLicense
MIT
Skillstore revision
r2
Version notice
The author did not declare a version.
Ref
c43861a65bb95efcae259cd161c9d6f4dc7eec6f
Maintenance freshness
7/25/2026
Usage
20 downloads · 124 views
File structure
📄 SKILL.md
Create Complete Product Requirements Documents
Vague product ideas cause unclear scope, weak acceptance criteria, and delivery risk. This skill turns stakeholder input into a structured, measurable Product Requirements Document.
Build Better Spring Boot Applications
Spring Boot projects can become inconsistent across architecture, configuration, data access, and testing. This skill provides focused practices for maintainable Java applications.
Refactor Code Without Changing Behavior
Complex code slows maintenance and makes changes risky. This skill guides small, tested refactoring steps that improve structure while preserving behavior.
Create Clear Conventional Git Commits
Inconsistent commits make project history difficult to review and maintain. This skill analyzes changes, stages logical groups, and creates standardized Conventional Commit messages.
Create Editable Excalidraw Diagrams
Manual diagram creation is slow and inconsistent. This skill converts natural language into editable Excalidraw files using templates, layout guidance, and optional icon tools.
Manage GitHub from the Command Line
GitHub teams need fast command guidance for repositories, issues, pull requests, Actions, and releases. This skill supplies focused gh CLI examples and workflows for Claude, Codex, and Claude Code.
Create Professional Markdown Documentation
by AutumnsGrove
Inconsistent project documentation makes installation, use, and contribution difficult. This skill supplies structured templates, formatting guidance, and local tools for maintainable Markdown.
Write Clear Metabase Documentation
by metabase
Technical documentation often becomes formal, vague, or difficult to scan. This skill helps Claude, Codex, and Claude Code write clear Metabase documentation with focused steps.
Format Markdown for Clearer Reading
by jimliu
Turn plain text or uneven Markdown into a structured document that readers can scan quickly. Preserve the author's content while improving headings, emphasis, lists, frontmatter, and typography.
Draft Reader-Tested Documentation
by ZhanlinCui
Complex documents often fail when readers lack the author's context. This skill guides context gathering, section drafting, iterative edits, and reader testing.
Create Audience-Focused READMEs
by softaworks
Generic READMEs often miss the needs of contributors, teammates, or future maintainers. This skill guides Claude, Codex, and Claude Code through audience questions, templates, and quality checks.
Generate Maintainable Documentation from Code
by sickn33
Outdated and inconsistent documentation slows development and creates support gaps. This skill turns code and configuration into structured documentation with validation and automation guidance.