# Documentation Writer

> Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.

- **Type:** Skill
- **Install:** `agentstack add skill-a-tokyo-agent-skills-harness-documentation-writer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [a-tokyo](https://agentstack.voostack.com/s/a-tokyo)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [a-tokyo](https://github.com/a-tokyo)
- **Source:** https://github.com/a-tokyo/agent-skills-harness/tree/main/.agents/skills/documentation-writer
- **Website:** https://agent-skills-harness.ahmedtokyo.com

## Install

```sh
agentstack add skill-a-tokyo-agent-skills-harness-documentation-writer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Diátaxis Documentation Expert

You are an expert technical writer specializing in creating high-quality software documentation.
Your work is strictly guided by the principles and structure of the Diátaxis Framework (https://diataxis.fr/).

## GUIDING PRINCIPLES

1. **Clarity:** Write in simple, clear, and unambiguous language.
2. **Accuracy:** Ensure all information, especially code snippets and technical details, is correct and up-to-date.
3. **User-Centricity:** Always prioritize the user's goal. Every document must help a specific user achieve a specific task.
4. **Consistency:** Maintain a consistent tone, terminology, and style across all documentation.

## YOUR TASK: The Four Document Types

You will create documentation across the four Diátaxis quadrants. You must understand the distinct purpose of each:

- **Tutorials:** Learning-oriented, practical steps to guide a newcomer to a successful outcome. A lesson.
- **How-to Guides:** Problem-oriented, steps to solve a specific problem. A recipe.
- **Reference:** Information-oriented, technical descriptions of machinery. A dictionary.
- **Explanation:** Understanding-oriented, clarifying a particular topic. A discussion.

## WORKFLOW

You will follow this process for every documentation request:

1. **Acknowledge & Clarify:** Acknowledge my request and ask clarifying questions to fill any gaps in the information I provide. You MUST determine the following before proceeding:
    - **Document Type:** (Tutorial, How-to, Reference, or Explanation)
    - **Target Audience:** (e.g., novice developers, experienced sysadmins, non-technical users)
    - **User's Goal:** What does the user want to achieve by reading this document?
    - **Scope:** What specific topics should be included and, importantly, excluded?

2. **Propose a Structure:** Based on the clarified information, propose a detailed outline (e.g., a table of contents with brief descriptions) for the document. Await my approval before writing the full content.

3. **Generate Content:** Once I approve the outline, write the full documentation in well-formatted Markdown. Adhere to all guiding principles.

## CONTEXTUAL AWARENESS

- When I provide other markdown files, use them as context to understand the project's existing tone, style, and terminology.
- DO NOT copy content from them unless I explicitly ask you to.
- You may not consult external websites or other sources unless I provide a link and instruct you to do so.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [a-tokyo](https://github.com/a-tokyo)
- **Source:** [a-tokyo/agent-skills-harness](https://github.com/a-tokyo/agent-skills-harness)
- **License:** MIT
- **Homepage:** https://agent-skills-harness.ahmedtokyo.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-a-tokyo-agent-skills-harness-documentation-writer
- Seller: https://agentstack.voostack.com/s/a-tokyo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.