skills.rest
remiverdiesen
remiverdiesenCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

ark-documentation

Organize Ark documentation into Diataxis Tutorials, How-to Guides, Core Concepts, and Reference.

6|Updated Nov 21, 2025
Search Tags:#documentation#guidance#structure#diataxis#content-organization#ark#documentation-principles
One-click install
npx skills add https://github.com/remiverdiesen/agents-at-scale --skill ark-documentation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ark-documentation
Source: https://github.com/remiverdiesen/agents-at-scale/tree/main/.claude/skills/documentation
Command: npx skills add https://github.com/remiverdiesen/agents-at-scale --skill ark-documentation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ark documentation often lacks a consistent structure, leading to fragmented guidance and onboarding friction. This skill provides a Diataxis-aligned blueprint to organize Ark docs into Tutorials, How-to Guides, Core Concepts, and Reference.

Core Features & Use Cases

  • Diataxis-aligned structure: Organizes content into Tutorials, How-to Guides, Core Concepts, and Reference for clear learning and lookup.
  • Hub pages and governance: Guides the creation of hub pages to surface content without relocating files and sets governance around categorization and placement.
  • Adapted for Ark needs: Tailors the Diataxis model to Ark's terminology and audience, promoting consistent terminology.

Quick Start

  • Review Ark's existing docs and map each piece to the appropriate Diataxis quadrant (Tutorials, How-to Guides, Core Concepts, Reference).
  • Create or adjust pages to populate the four quadrants and add hub pages linking to content.
  • Align new or restructured content with Ark terminology and document governance.

Frequently Asked Questions about ark-documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure technical documentation using the Diataxis framework?▼

Structure technical documentation using the Diataxis framework by categorizing content into four distinct quadrants: Tutorials, How-to Guides, Core Concepts, and Reference. This approach improves content discoverability and ensures consistent onboarding.

What is the best way to organize fragmented documentation for better discoverability?▼

Organize fragmented documentation by mapping existing pieces to the Diataxis quadrants and creating hub pages. Hub pages surface content without relocating files, establishing clear governance around categorization and placement.

How do I map existing content to Tutorials, How-to Guides, Core Concepts, and Reference?▼

Map existing content by reviewing current documentation and assigning each piece to the appropriate Diataxis quadrant. Adjust or create new pages to populate Tutorials, How-to Guides, Core Concepts, and Reference fully.

Does Ark documentation require a specific format to apply content organization principles?▼

Ark documentation requires a SKILL.md file with YAML frontmatter including name and description, and a Markdown body outlining usage guidelines. This format enforces the structure needed to apply content organization principles effectively.

When should I use hub pages instead of relocating documentation files during restructuring?▼

Use hub pages during documentation restructuring when you need to surface categorized content without disrupting the existing file hierarchy. This approach maintains file locations while improving navigation and governance.

Related Skills

Explore More Content & Communication Skills→
sammcjsammcj
155

writing-documentation-with-diataxis

Apply the Diataxis framework to identify and structure technical documentation types.

Community
Basic
scanbottscanbott

competitor-alternatives

Generate SEO-optimized competitor comparison pages with modular templates and cross-linking.

Community
Advanced
ddttomddttom

md-workflow

Create, edit, and lint Markdown files with YAML frontmatter awareness.

Community
Intermediate
mckinseymckinsey
413

ark-documentation

Organizes Ark documentation using the Diataxis framework and taxonomy.

Official
Intermediate