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.
79
81%
Does it follow best practices?
Impact
97%
1.32xAverage score across 2 eval scenarios
Passed
No findings from the security scan
Evaluation results
99%
27%Pipeline CRD reference page
CRD reference page using 7-section template
Frontmatter present
100%
100%
Description format
0%
100%
Intro section
100%
100%
## Spec section
50%
100%
## Fields section
0%
100%
Fields table completeness
62%
100%
## Status section
50%
100%
Status phases table
100%
100%
## Related section
50%
100%
Product name 'Ark'
100%
100%
Sentence-case headings
100%
100%
No gerund headings
100%
100%
Bullet formatting
100%
100%
Active voice
83%
83%
Descriptive hyperlinks
100%
100%
No instructional prose
100%
100%
96%
22%Write a first-agent tutorial for Ark
Tutorial authoring style and structure compliance
Numbered linear steps
40%
100%
Next step section
90%
100%
We language
25%
75%
No inline concept explanations
62%
87%
No gerund headings
100%
100%
Sentence case headings
37%
100%
Product name spelling
100%
100%
Imperative voice instructions
100%
100%
Active voice prose
87%
100%
No business speak
100%
100%
Bullet formatting
33%
83%
Descriptive hyperlinks
100%
100%
US English and Oxford commas
100%
100%
- Repository
- mckinsey/agents-at-scale-ark
- Commit
b018d5b
- 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.