CtrlK
BlogDocsLog inGet started
Tessl Logo

c4-context

Expert C4 Context-level documentation specialist. Creates high-level system context diagrams, documents personas, user journeys, system features, and external dependencies.

55

1.34x
Quality

32%

Does it follow best practices?

Impact

97%

1.34x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/c4-context/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

42%

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 a good job listing specific concrete deliverables (context diagrams, personas, user journeys, etc.) and anchors itself to the C4 modeling framework. However, it critically lacks any 'Use when...' guidance, making it difficult for Claude to know when to select this skill over others. The trigger terms lean toward domain-specific jargon rather than natural user language.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks for architecture documentation, system context diagrams, C4 models, or needs to document how users and external systems interact with the system.'

Include natural trigger term variations users might say, such as 'architecture overview', 'system diagram', 'stakeholder map', 'dependency mapping', or 'high-level architecture'.

Clarify boundaries to reduce overlap with other skills, e.g., specify that this is for C4 Level 1 (Context) only, distinguishing it from container, component, or code-level documentation skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: creates context diagrams, documents personas, user journeys, system features, and external dependencies. These are clearly defined deliverables.

3 / 3

Completeness

Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant terms like 'C4', 'context diagrams', 'personas', 'user journeys', but misses common user phrasings like 'architecture diagram', 'system overview', 'stakeholder mapping', or file format references. 'C4' is somewhat niche jargon that not all users would naturally say.

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 explicit trigger boundaries, conflict risk remains moderate.

2 / 3

Total

8

/

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 is primarily a documentation template with placeholders rather than actionable instructions for Claude. While the Mermaid C4 diagram example is useful and concrete, the bulk of the content is generic template scaffolding and vague instructions that don't teach Claude how to actually perform the task of creating C4 context documentation. The skill would benefit significantly from a clear workflow, concrete decision-making guidance, and removal of placeholder templates in favor of a real worked example.

Suggestions

Replace the placeholder template sections with a concrete worked example showing a real system's context documentation, so Claude can learn the pattern by example rather than filling in brackets.

Add a clear numbered workflow: e.g., 1) Identify system purpose, 2) Enumerate personas from codebase/docs, 3) Map features to personas, 4) Identify external dependencies, 5) Generate Mermaid diagram, 6) Validate completeness by cross-referencing.

Remove the generic 'Use this skill when / Do not use this skill when' boilerplate and the vague four-bullet Instructions section - replace with specific, actionable guidance on how to analyze a codebase or documentation to extract context-level information.

Add validation checkpoints such as 'Verify every external system in the diagram appears in the External Systems section' and 'Confirm every persona has at least one user journey mapped'.

DimensionReasoningScore

Conciseness

The skill is highly 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 boilerplate 'Use this skill when / Do not use this skill when' sections with generic content, and the 'Output Examples' section is just a bullet list of what to produce rather than an actual example. The 'Example Interactions' section lists generic prompts that add no instructional value.

1 / 3

Actionability

The Mermaid diagram template is concrete and executable, which is valuable. However, most of the content is template structure with placeholders rather than actionable instructions. The 'Instructions' section is extremely vague ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices'). There's no concrete guidance on how to actually gather information, analyze a system, or make decisions about what to include.

2 / 3

Workflow Clarity

There is no clear workflow sequence for creating context documentation. The instructions are four generic bullet points with no ordering logic. There are no validation checkpoints - no step to verify completeness of personas, validate the diagram against documented systems, or check that all external dependencies are captured. For a multi-step documentation task, this is insufficient.

1 / 3

Progressive Disclosure

There is a reference to 'resources/implementation-playbook.md' for detailed examples, and mentions of related Container/Component documentation. However, the main file itself contains a lot of template content that could be in a separate template file, and the references to related documentation are not linked. The structure has clear sections but the content organization could be improved.

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
sickn33/antigravity-awesome-skills
Reviewed

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.