Expert C4 Context-level documentation specialist. Creates high-level system context diagrams, documents personas, user journeys, system features, and external dependencies.
49
37%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/c4-context/SKILL.mdQuality
Discovery
60%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description does well at listing specific concrete deliverables and naming the C4 framework, giving it reasonable specificity. However, it lacks an explicit 'Use when...' clause, which limits its completeness and makes it harder for Claude to know exactly when to select this skill. The trigger terms are somewhat technical and could overlap with adjacent skills covering UX or other architecture documentation.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks for C4 context diagrams, system overviews, architecture documentation, or high-level system mapping.'
Include common user-facing trigger variations such as 'architecture diagram', 'system overview', 'C4 model', 'stakeholder mapping', or 'system boundary diagram' to improve discoverability.
Clarify scope boundaries to reduce overlap, e.g., 'Focuses on C4 Level 1 (System Context) only — not Container, Component, or Code level diagrams.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Creates high-level system context diagrams, documents personas, user journeys, system features, and external dependencies.' These are distinct, concrete deliverables. | 3 / 3 |
Completeness | Clearly answers 'what does this do' with specific actions, but lacks an explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied by the domain description, which per the rubric caps completeness at 2. | 2 / 3 |
Trigger Term Quality | Includes some relevant terms like 'C4', 'context diagrams', 'personas', 'user journeys', 'external dependencies', but misses common user phrasings. Users might say 'architecture diagram', 'system overview', or 'C4 model' — 'C4 Context-level' is somewhat technical jargon that not all users would naturally use. | 2 / 3 |
Distinctiveness Conflict Risk | The 'C4 Context-level' qualifier provides some distinctiveness, but terms like 'personas', 'user journeys', and 'system features' could overlap with UX design skills, product management skills, or other C4 level skills (Container, Component). Without explicit scoping, there's moderate conflict risk. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is primarily a template skeleton with placeholder brackets rather than actionable guidance for Claude. It explains C4 concepts Claude already knows, lacks a clear workflow for producing context documentation, and references a non-existent bundle file. The one bright spot is the concrete Mermaid C4Context diagram example, but the rest is too vague and verbose to be effective.
Suggestions
Replace the generic 'Instructions' section with a clear numbered workflow: e.g., 1) Read existing docs/code, 2) Identify personas, 3) Map features to personas, 4) Document external dependencies, 5) Generate Mermaid diagram, 6) Validate completeness against checklist.
Remove the template scaffolding with placeholder brackets and instead provide one complete, concrete example of a filled-out C4 context document for a real-ish system (e.g., an e-commerce platform).
Remove sections Claude doesn't need: 'Use this skill when/Do not use this skill when', 'Key Distinctions', 'Example Interactions', and the C4 concept explanation. Claude knows what C4 is.
Either provide the referenced 'resources/implementation-playbook.md' as a bundle file or remove the reference entirely to avoid broken navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose with extensive template scaffolding (placeholder brackets like '[One-sentence description]', '[Persona Name]') that Claude doesn't need. It explains basic C4 concepts Claude already knows, includes unnecessary sections like 'Use this skill when/Do not use this skill when', 'Example Interactions', and 'Key Distinctions' that add little actionable value. The output examples section is a bullet list of vague descriptions rather than concrete guidance. | 1 / 3 |
Actionability | The Mermaid diagram template is concrete and executable, which is valuable. However, most of the content consists of empty templates with placeholder brackets rather than actionable instructions. The 'Instructions' section is extremely vague ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices'). It references 'resources/implementation-playbook.md' but no bundle files exist. | 2 / 3 |
Workflow Clarity | There is no clear workflow sequence for creating C4 context documentation. The instructions are four generic bullet points with no ordering, no validation checkpoints, and no feedback loops. For a multi-step documentation task (identify personas, map journeys, document dependencies, create diagram), the lack of sequencing and verification steps is a significant gap. | 1 / 3 |
Progressive Disclosure | References 'resources/implementation-playbook.md' but no bundle files exist, making this a broken reference. The skill is a monolithic document mixing templates, examples, principles, and instructions without clear separation. Content that could be in separate files (templates, examples) is all inline, and the referenced file doesn't exist to support progressive disclosure. | 1 / 3 |
Total | 5 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
1930a07
Table of Contents
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.