Expert C4 Context-level documentation specialist. Creates high-level system context diagrams, documents personas, user journeys, system features, and external dependencies.
41
41%
Does it follow best practices?
Impact
—
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 score, and some of its terms (personas, user journeys) could overlap with non-architecture skills. Adding trigger guidance and more natural user keywords would significantly improve skill selection accuracy.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks for C4 diagrams, system context documentation, architecture overviews, or needs to map external systems and actors.'
Include natural keyword variations users might say, such as 'architecture diagram', 'system overview', 'C4 model', 'context map', or 'system boundary'.
Clarify scope boundaries to reduce overlap, e.g., 'Focuses on C4 Level 1 (Context) diagrams only, not container or component level' to distinguish from other architecture skills.
| 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 capabilities listed, which caps this at 2 per the rubric guidelines. | 2 / 3 |
Trigger Term Quality | Includes some relevant terms like 'C4', 'context diagrams', 'personas', 'user journeys', 'external dependencies', but misses common user phrasings and variations. Users might say 'architecture diagram', 'system overview', or 'C4 model' which aren't explicitly covered. | 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 architecture documentation skills. Without clearer scoping, there's moderate conflict risk. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a documentation template with placeholder brackets than actionable instructions for Claude. While the Mermaid C4Context diagram example is a genuine strength, the bulk of the content is verbose scaffolding, generic instructions, and explanations of concepts Claude already knows. The lack of a clear workflow sequence and validation steps makes it difficult for Claude to follow a structured process for creating C4 context documentation.
Suggestions
Replace the generic 4-bullet 'Instructions' section with a clear numbered workflow: e.g., 1) Gather system info → 2) Identify personas → 3) Map features to personas → 4) Document user journeys → 5) Identify external dependencies → 6) Generate Mermaid diagram → 7) Validate completeness
Remove the template scaffolding with placeholder brackets and instead provide one concrete, filled-in example of a complete C4 context document for a real system (e.g., an e-commerce platform), which Claude can pattern-match against
Cut the 'Use this skill when/Do not use this skill when', 'Example Interactions', 'Key Distinctions', and 'Limitations' sections — these consume tokens without adding actionable value that Claude doesn't already know
Add explicit validation checkpoints, such as 'Verify all external system integrations are bidirectionally documented' and 'Confirm every persona has at least one user journey mapped'
| 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 'Key Principles' section restates what the C4 model is, which Claude already understands. | 1 / 3 |
Actionability | The Mermaid diagram template is concrete and executable, which is valuable. However, most of the content is template scaffolding with placeholder brackets rather than actionable instructions. The 'Instructions' section is extremely vague ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices'). The output is more of a documentation template than executable guidance. | 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, validation checkpoints, or feedback loops. For a multi-step documentation task (identify personas → map features → document journeys → create diagram), the lack of sequencing and validation is a significant gap. | 1 / 3 |
Progressive Disclosure | There is a reference to 'resources/implementation-playbook.md' but no bundle files are provided, making it unclear if this reference is valid. The content includes sections like 'Related Documentation' pointing to Container and Component documentation, but these are just text labels without links. The document itself is somewhat organized with clear headers but includes too much inline template content that could be in a separate template file. | 2 / 3 |
Total | 6 / 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 | |
fb2efea
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.