New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Diataxis Documentation Architect

by GulajavaMinistudio in GulajavaMinistudio/Mayukai-Theme

Workflow for auditing, designing, and writing structured documentation based on the Diátaxis Framework (Tutorials, How-to, Reference, Explanation).

MITAuto-check passed

Install Diataxis Documentation Architect

skills CLI
$ npx skills add GulajavaMinistudio/Mayukai-Theme --skill diataxis-documentation-architect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install GulajavaMinistudio/Mayukai-Theme diataxis-documentation-architect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/GulajavaMinistudio/Mayukai-Theme.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/diataxis-documentation-architect .claude/skills/diataxis-documentation-architect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
diataxis-documentation-architect
GitHub stars
139
Token cost
~953 tokens
SKILL.md length
453 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Workflow for auditing, designing, and writing structured documentation based on the Diátaxis Framework (Tutorials, How-to, Reference, Explanation).

  • Works in 7 steps: 🎓 TUTORIALS (Learning-oriented) → 🛠️ HOW-TO GUIDES (Task-oriented) → 📖 REFERENCE (Information-oriented) → …
  • SKILL.md covers Overview, When to Use, 🧭 The 4 Quadrants (Strict… and ⚙️ Operational Workflow, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Diataxis Documentation Architect is an agent skill from GulajavaMinistudio/Mayukai-Theme. Workflow for auditing, designing, and writing structured documentation based on the Diátaxis Framework (Tutorials, How-to, Reference, Explanation).

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Visual Studio Code. The repository describes itself as: Combination theme for VS Code and VSCodium that inspired from Ayu Theme, Monokai , Andromeda, Material Color, and Gruvbox Darktooth Color. The licence is MIT.

Example prompts

  • “/diataxis-documentation-architect”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 🎓 TUTORIALS (Learning-oriented)
  2. 🛠️ HOW-TO GUIDES (Task-oriented)
  3. 📖 REFERENCE (Information-oriented)
  4. 💡 EXPLANATION (Understanding-oriented)
  5. Audit & Clarify
  6. Design & Outline
  7. Drafting & File Creation

What it can do on your machine

Read from SKILL.md and the folder at commit c8c9159. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Diataxis Documentation Architect loads about 953 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 453 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~953

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from GulajavaMinistudio/Mayukai-Theme at commit c8c9159, republished under its MIT licence (© GulajavaMinistudio). 453 words, ~953 tokens.

Download SKILL.mdSave it as .claude/skills/diataxis-documentation-architect/SKILL.md (or your agent's skills folder).
name
diataxis-documentation-architect
description
Workflow for auditing, designing, and writing structured documentation based on the Diátaxis Framework (Tutorials, How-to, Reference, Explanation).
license
MIT
<!-- markdownlint-disable -->

Diátaxis Documentation Architect Skill

Overview

This skill outlines the workflow to design documentation architecture and create high-quality documentation strictly adhering to the Diátaxis Framework. It ensures every piece of documentation serves one specific purpose and does not mix modes. This skill accompanies the @DiataxisDocumentationArchitect agent.

When to Use

  • When creating user-facing or developer-facing documentation.
  • When generating tutorials, how-to guides, reference material, or conceptual explanations.

🧭 The 4 Quadrants (Strict Rules)

1. 🎓 TUTORIALS (Learning-oriented)
  • Goal: Allow the beginner to learn by doing a specific project.
  • Characteristics: Instructional, step-by-step, builds understanding incrementally. Assumes no prior knowledge.
  • Voice: Second person ("You"). Encouraging and prescriptive.
  • Rule: NO abstract theory. NO choices/alternatives. Just "do this, then do that."
2. 🛠️ HOW-TO GUIDES (Task-oriented)
  • Goal: Solve a specific problem or complete a task.
  • Characteristics: A recipe. Series of steps to achieve a concrete result. Assumes some familiarity.
  • Voice: Second person ("You"). Direct and action-oriented.
  • Rule: NO teaching "basic concepts". Get straight to the solution.
3. 📖 REFERENCE (Information-oriented)
  • Goal: Provide factual description of components.
  • Characteristics: Concise, exhaustive. API specs, class descriptions, parameter lists.
  • Voice: Third person or passive voice. Technical, dry, and austere.
  • Rule: NO instructional steps. Just facts. Map the code 1:1 to text.
4. 💡 EXPLANATION (Understanding-oriented)
  • Goal: Deepen understanding and clarify context, background, and "Why".
  • Characteristics: Discursive, contextual. Discusses design decisions, trade-offs, and concepts.
  • Voice: Engaging narrative.
  • Rule: NO code snippets (unless for illustration). NO instructions.

⚙️ Operational Workflow

Follow this process sequentially:

Phase 1: Audit & Clarify
  1. Analyze Request: Determine the target audience, the project's maturity, and existing materials.
  2. Clarification Checkpoint: If the request is too broad, ask the user which specific component or quadrant to focus on first. MUST ask whether they prefer Markdown (.md) or Plain Text (.txt).
  3. Scan Codebase: Use search/read tools to look at the actual code, functions, or APIs.
Show full SKILL.md (154 more words)Show less
Phase 2: Design & Outline
  1. Propose Strategy: Tell the user: "I recommend writing a [Quadrant Name] document to achieve this."
  2. Outline: Create a bulleted outline of the document structure tailored to the specific quadrant.
  3. Wait for Approval: Do not write the full document until the user approves the outline.
Phase 3: Drafting & File Creation
  1. Write the content in clear, professional formatting (in Bahasa Indonesia by default).
  2. Verify Code: Ensure every code snippet in the docs matches the actual codebase logic perfectly.
  3. File Management: Save the document to a logically categorized folder (e.g., /docs/tutorials/, /docs/reference/).

🛑 Anti-Patterns (What to Avoid)

  • The "All-in-One" Trap: Do not write a document that tries to teach a concept AND list every API parameter AND show a tutorial. Split them up into separate files.
  • Assuming Knowledge: In Tutorials, assume zero knowledge. In How-Tos, assume basic competence.
  • Outdated Info: Always verify facts against the current codebase results.

© GulajavaMinistudio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/diataxis-documentation-architect of GulajavaMinistudio/Mayukai-Theme.

Open the folder on GitHubat commit c8c9159

Compare with similar skills

Diataxis Documentation Architect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Diataxis Documentation Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Diataxis Documentation Architect this skillGulajavaMinistudio/Mayukai-Theme139—~953Automated safety check: PassMIT
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Electron App Automationvercel-labs/agent-browser44k5 repos~1.7kAutomated safety check: PassApache-2.0
Microsoft Skill CreatorMicrosoftDocs/mcp1.9k3 repos~2.1kAutomated safety check: PassCC-BY-4.0
Evals Contextzgsm-ai/costrict4.5k1 repos~1.9kAutomated safety check: PassApache-2.0
Ketch1broseidon/ketch7021 repos~3.9kAutomated safety check: PassMIT

Similar skills

  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed

  • Electron App Automation

    vercel-labs/agent-browser

    Official

    Automates Electron desktop apps such as VS Code, Slack or Discord by connecting agent-browser to their Chrome DevTools Protocol port.

    44k GitHub starsUsed in 5 repos~1.7k tokens
    Productivity & AutomationAuto-check passed

  • Microsoft Skill Creator

    MicrosoftDocs/mcp

    Official

    Create agent skills for Microsoft technologies using official documentation.

    1.9k GitHub starsUsed in 3 repos~2.1k tokens
    Agent WorkflowsAuto-check passed

  • Evals Context

    zgsm-ai/costrict

    Provides context about the CoStrict evals system structure in this monorepo.

    4.5k GitHub starsUsed in 1 repo~1.9k tokens
    AI & LLM EngineeringAuto-check passed

  • Ketch

    1broseidon/ketch

    Research skill for ketch — a fast stateless CLI for web search, OSS code search, curated library docs, page scraping, and site crawling; an optional MCP server exists for operators who want it, but…

    702 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed

  • Make Custom Agent

    dotnet/efcore

    Official

    Create custom GitHub Copilot agents. An agent skill from dotnet/efcore.

    15k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

More from GulajavaMinistudio/Mayukai-Theme

All 11 skills in this repo

  • Omni Dev

    GulajavaMinistudio/Mayukai-Theme

    Omni-expert principal software architect. An agent skill from GulajavaMinistudio/Mayukai-Theme.

    139 GitHub stars~736 tokensUpdated 3 mo ago
    Auto-check passed

  • Artifact Consistency Checker

    GulajavaMinistudio/Mayukai-Theme

    Performs consistency and traceability audits across documents (PRD vs Spec vs Plan) to detect missing coverage and scope creep.

    139 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed

  • Brainstorming Explorer

    GulajavaMinistudio/Mayukai-Theme

    Systematic codebase exploration, architectural critique, and generation of Project Discovery Drafts for SDLC Phase 0.

    139 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed

  • Bug Remediation Architect

    GulajavaMinistudio/Mayukai-Theme

    Workflow for analyzing bug reports, tracing root causes, and generating structured bug-fix implementation plans with rollback strategies.

    139 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed

  • Clarification Analyst

    GulajavaMinistudio/Mayukai-Theme

    Helps interrogate Product Requirements (PRD), Technical Specifications, and Implementation Plans to find ambiguities, missing edge cases, and hidden assumptions.

    139 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed

  • Expert Code Reviewer

    GulajavaMinistudio/Mayukai-Theme

    Language-agnostic workflow for code reviews and security audits against Clean Code/SOLID principles, generating formal refactoring plans.

    139 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Diataxis Documentation Architect

What does Diataxis Documentation Architect do?

Workflow for auditing, designing, and writing structured documentation based on the Diátaxis Framework (Tutorials, How-to, Reference, Explanation). Diataxis Documentation Architect is an agent skill from GulajavaMinistudio/Mayukai-Theme. Workflow for auditing, designing, and writing structured documentation based on the Diátaxis Framework (Tutorials, How-to, Reference, Explanation).

How do I install Diataxis Documentation Architect in Claude Code?

Run `npx skills add GulajavaMinistudio/Mayukai-Theme --skill diataxis-documentation-architect -a claude-code`. Or copy the skill folder (.agents/skills/diataxis-documentation-architect in GulajavaMinistudio/Mayukai-Theme) into .claude/skills/diataxis-documentation-architect in your project. Claude Code loads it when a task matches its description.

How do I install Diataxis Documentation Architect in Codex?

Run `npx skills add GulajavaMinistudio/Mayukai-Theme --skill diataxis-documentation-architect -a codex`. Or copy the skill folder (.agents/skills/diataxis-documentation-architect in GulajavaMinistudio/Mayukai-Theme) into .agents/skills/diataxis-documentation-architect in your project. Codex loads it when a task matches its description.

Can I use Diataxis Documentation Architect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GulajavaMinistudio/Mayukai-Theme --skill diataxis-documentation-architect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/diataxis-documentation-architect, .gemini/skills/diataxis-documentation-architect, .github/skills/diataxis-documentation-architect and .opencode/skills/diataxis-documentation-architect in your project.

What does Diataxis Documentation Architect need to run?

SKILL.md names no scripts, command-line tools or credentials: Diataxis Documentation Architect is instructions for the agent only.

Does Diataxis Documentation Architect access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Diataxis Documentation Architect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Diataxis Documentation Architect use?

Diataxis Documentation Architect is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Diataxis Documentation Architect use?

About 953 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Diataxis Documentation Architect?

Skills that share tags, products or a category with Diataxis Documentation Architect: Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Electron App Automation (vercel-labs/agent-browser, 44k stars), Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars) and Evals Context (zgsm-ai/costrict, 4.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Diataxis Documentation Architect?

GulajavaMinistudio (a GitHub user) maintains it in GulajavaMinistudio/Mayukai-Theme, which has 139 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on July 1, 2026.

Source: GulajavaMinistudio/Mayukai-Theme on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.