ark-documentation
Guidance for structuring Ark documentation using the Diataxis framework. Use this skill when creating new docs, deciding where content belongs, reviewing documentation PRs, or restructuring existing documentation.
83
76%
Does it follow best practices?
Impact
93%
1.17xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/documentation/SKILL.mdEvaluation results
96%
6%ARK Documentation Audit and Reorganization
Content classification and hub page structure
Tutorials classification
100%
100%
How-to guide classification
100%
100%
Core Concepts classification
100%
100%
Reference classification
100%
100%
Persona assignment
75%
87%
Content mixing: Item A
100%
100%
Content mixing: Item H
100%
100%
Hub page: one-sentence purpose
75%
62%
Hub page: correct grouping
62%
100%
Hub page: no duplicate content
100%
100%
ARK capitalization
100%
100%
Correct section name
100%
100%
Hub page heading style
40%
100%
Descriptive links
100%
100%
85%
17%Write an ARK Quickstart Tutorial
Tutorial writing conventions
Numbered steps
80%
100%
Single prescribed path
70%
100%
We language
10%
0%
No inline explanations
62%
75%
Link to Core Concepts
37%
100%
Next step ending
87%
100%
No gerunds in headings
100%
100%
Sentence case headings
37%
100%
ARK capitalization
100%
100%
Active voice
87%
100%
No business speak
100%
100%
Bullet punctuation
57%
57%
98%
18%Revise ARK Documentation Drafts for Style Compliance
Writing style and style-guide compliance
ARK capitalization fixed
100%
100%
Business speak removed
100%
100%
Passive voice corrected
100%
100%
No 'please'
100%
100%
Descriptive links
100%
100%
Gerund headings fixed
0%
75%
Sentence case headings
0%
100%
Bullet capitalization and punctuation
50%
100%
Capitalization rules applied
100%
100%
Audit files present
100%
100%
No new violations introduced
100%
100%
- Repository
- mckinsey/agents-at-scale-ark
- Commit
f4bfd2d
- Evaluated
- Agent
- Claude Code
- Model
- Claude Sonnet 4.6
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.