ark-documentation

Organizes Ark documentation using the Diataxis framework and taxonomy.

413|97|Updated Aug 28, 2025

Search Tags:#documentation #taxonomy #diataxis #content-organization #writing-guidelines #ark #hub-pages

Ready to run

npx skills add https://github.com/mckinsey/agents-at-scale-ark --skill ark-documentation-mckinsey

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ark-documentation
Source: https://github.com/mckinsey/agents-at-scale-ark/tree/main/.claude/skills/documentation
Command: npx skills add https://github.com/mckinsey/agents-at-scale-ark --skill ark-documentation-mckinsey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ark documentation often lacks a consistent structure, making it difficult for users to locate guidance. This skill provides a Diataxis-aligned framework to organize Ark content and improve discoverability.

Core Features & Use Cases

Provides a Diataxis-aligned taxonomy for Ark content (Introduction, Quickstart, Tutorials, How-to Guides, Core Concepts, Reference, Marketplace, Disclaimer).
Defines terminology and hub pages to organize content and guide contributors.
Offers guidance for when to create, move, or review documentation within Ark.

Quick Start

Organize ARK documentation using the Diataxis framework by starting with Core Concepts and Tutorials sections.

Frequently Asked Questions about ark-documentation

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

FAQPage Schema

How do I structure documentation using the Diataxis framework?▼

To structure documentation with Diataxis, you categorize content into Introduction, Quickstart, Tutorials, How-to Guides, Core Concepts, and Reference. This skill defines that taxonomy specifically for Ark content to improve discoverability and guide contributors.

What is the best way to organize Ark hub pages for technical content?▼

Organizing Ark hub pages involves implementing a Diataxis-aligned taxonomy that separates content into Introduction, Quickstart, Tutorials, How-to Guides, Core Concepts, and Reference sections. This structure guides contributors and improves content discoverability.

How do I decide where new content belongs when reviewing documentation PRs?▼

To decide where new content belongs during PR reviews, map the submission against the Diataxis-based taxonomy. Check whether the content functions as a Tutorial, How-to Guide, Core Concept, or Reference entry to place it in the correct Ark hub page.

How do I start creating new Ark docs with a consistent content organization?▼

You start creating new Ark docs by placing them in the Core Concepts or Tutorials sections. The skill provides writing guidelines and a defined taxonomy to ensure your new documentation integrates consistently with the existing Ark structure.

When should I restructure existing Ark content into a new taxonomy?▼

Restructure existing Ark content when it lacks consistent structure and users struggle to locate guidance. Moving content into the Diataxis-aligned hub pages defined by this skill improves discoverability and aligns the documentation with standard writing guidelines.

Does this content organization approach work for marketplace and disclaimer documentation?▼

Yes, the Diataxis-aligned taxonomy explicitly includes Marketplace and Disclaimer as dedicated hub pages. This ensures that all specific Ark content types, including commercial and legal documentation, are categorized and organized consistently.