CtrlK
BlogDocsLog inGet started
Tessl Logo

c4-architecture

Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".

Install with Tessl CLI

npx tessl i github:softaworks/agent-toolkit --skill c4-architecture
What are skills?

Overall
score

86%

Does it follow best practices?

Validation for skill structure

SKILL.md
Review
Evals

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the marks. It clearly specifies the capability (C4 model Mermaid diagrams for architecture documentation), provides explicit 'Use when' guidance, and includes a comprehensive list of trigger terms that users would naturally say. The description is concise, uses third person voice, and carves out a distinct niche.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Generate architecture documentation', 'C4 model Mermaid diagrams', and explicitly mentions the four C4 diagram types (context/container/component/deployment diagrams).

3 / 3

Completeness

Clearly answers both what ('Generate architecture documentation using C4 model Mermaid diagrams') and when ('Use when asked to create architecture diagrams...') with an explicit list of triggers.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say, including 'architecture diagram', 'C4 diagram', 'system context', 'container diagram', 'component diagram', 'deployment diagram', 'document architecture', and 'visualize architecture' - all terms users would naturally use.

3 / 3

Distinctiveness Conflict Risk

Very clear niche focused specifically on C4 model architecture diagrams with Mermaid output. The specific mention of C4 diagram types and architecture visualization creates a distinct domain unlikely to conflict with general diagramming or documentation skills.

3 / 3

Total

12

/

12

Passed

Implementation

73%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, actionable skill with excellent concrete examples and good progressive disclosure. The main weaknesses are some redundancy in content (element syntax duplicating examples) and missing validation steps in the workflow for verifying diagram correctness. The skill would benefit from trimming redundant sections and adding explicit verification guidance.

Suggestions

Add validation steps to the workflow, such as 'Verify diagram renders correctly in Mermaid preview' and 'Confirm architecture matches actual codebase structure with stakeholders'

Consolidate the Element Syntax section - consider moving it entirely to references/c4-syntax.md since the examples already demonstrate the syntax in context

DimensionReasoningScore

Conciseness

The skill is comprehensive but includes some redundancy - the element syntax section largely duplicates what's shown in examples, and some explanations (like the audience table appearing twice) could be consolidated. However, it avoids explaining basic concepts Claude would know.

2 / 3

Actionability

Excellent actionability with fully executable Mermaid code examples for every diagram type, complete syntax references, and copy-paste ready templates. The examples are concrete and immediately usable.

3 / 3

Workflow Clarity

The workflow section at the top provides a clear 4-step sequence, but lacks validation checkpoints. There's no guidance on how to verify diagrams render correctly or validate that the architecture accurately represents the codebase before finalizing documentation.

2 / 3

Progressive Disclosure

Well-structured with clear sections progressing from quick start to advanced patterns. References to external files (common-mistakes.md, c4-syntax.md, advanced-patterns.md) are clearly signaled and one level deep. Output location guidance is helpful.

3 / 3

Total

10

/

12

Passed

Validation

88%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata' field is not a dictionary

Warning

license_field

'license' field is missing

Warning

Total

14

/

16

Passed

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.