Does it enforce specific writing styles?

Yes, it enforces US English, active voice, Oxford commas, and specific ARK-related terminology and capitalization rules, such as using 'ARK' instead of 'Ark'.

What is the Diataxis framework used in this skill?

Diataxis is a systematic approach to technical documentation that splits content into four distinct quadrants: Tutorials (learning-oriented), How-to guides (task-oriented), Core concepts (understanding-oriented), and Reference (information-oriented).

How does it handle different user personas?

The skill organizes content based on four primary personas: End users (Quickstart), Agent builders (Tutorials/Build guides), Platform engineers (Operate/Reference), and Contributors (Extend guides/Core Concepts).

Can this skill help with documentation PR reviews?

Yes, it is specifically designed to review documentation pull requests to ensure content is categorized correctly, follows stylistic guidelines, and remains concise and direct.

ARK Documentation Expert

Name: ARK Documentation Expert
Author: mckinsey

bymckinsey

•

305

•

Gestión de Contenido

Applies the Diataxis framework to structure, write, and review high-quality technical documentation for ARK projects.

The ARK Documentation skill provides specialized guidance for maintaining the McKinsey ARK documentation ecosystem using the Diataxis framework. It helps developers and technical writers distinguish between tutorials, how-to guides, core concepts, and reference materials, ensuring that content is persona-driven, consistent in tone, and logically organized. Whether you are drafting new documentation from scratch, restructuring existing folders, or reviewing pull requests, this skill enforces strict writing standards and implementation patterns to improve developer experience and information discoverability across agentic resource operations.

Características Principales

01Enforces ARK-specific writing style, lexicon, and capitalization standards.

02Implements the four-quadrant Diataxis framework for structured technical content.

03Provides structural templates for hub pages and documentation directories.

04Automates documentation PR reviews to ensure content-type consistency.

05Maps documentation tasks to specific personas including Agent builders and Platform engineers.

06305 GitHub stars

Casos de Uso

01Reviewing documentation pull requests to ensure task-oriented guides don't mix with reference material.

02Structuring a new project's documentation directory according to ARK's Diataxis quadrants.

03Converting technical design notes into polished 'Core Concepts' or 'How-to' guides for specific personas.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mckinsey/agents-at-scale-ark documentation

For use in Claude.ai and ChatGPT

Download Skill