CtrlK
BlogDocsLog inGet started
Tessl Logo

c4-container

Expert C4 Container-level documentation specialist.

39

Quality

38%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/c4-container/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%Weight 40%Scale 1-5

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

The body functions as a documentation template with useful concrete artifacts (Mermaid C4Container syntax, OpenAPI template) and clear section organization, but it lacks any sequenced workflow with validation checkpoints, leans on generic filler instructions, re-explains C4 basics, contains broken code fences, and points to a bundle file that does not exist. It is a mediocre template, not an actionable procedure.

Suggestions

Replace the generic Instructions bullets with a numbered synthesis workflow (e.g. gather deployment definitions -> group components into containers -> document interfaces -> generate diagram) with an explicit validation step before finalizing output.

Fix the markdown fencing errors (stray '````' lines after the Mermaid block and around the OpenAPI template) and remove or correct the broken reference to 'resources/implementation-playbook.md', which does not exist in the bundle.

Trim the 'Key Principles' section and generic 'Use this skill when'/'Do not use this skill when' boilerplate that restate what Claude already knows about C4 models, keeping only skill-specific guidance.

DimensionReasoningScore

Conciseness

The body is mostly output templates (container spec, OpenAPI YAML, Mermaid) rather than padded explanation, but the 'Key Principles (from c4model.com)' section restates C4 concepts Claude already knows and the generic 'Instructions' bullets ('Clarify goals, constraints, and required inputs') add little. Broken stray '````' fence lines (after the Mermaid block and around the OpenAPI template) further signal untightened content — above anchor 2's noticeable verbosity, below anchor 4's efficiency.

3 / 5

Actionability

There is some concrete guidance — a complete Mermaid C4Container example and an OpenAPI 3.1 YAML template — but the core instructions are vague direction ('Apply relevant best practices and validate outcomes', 'Provide actionable steps and verification') and the container templates are placeholder skeletons rather than executable artifacts. Anchor 3 (some concrete guidance, incomplete) fits best; anchor 4 would require mostly executable, gap-free guidance.

3 / 5

Workflow Clarity

No multi-step sequence exists anywhere in the body: the Instructions section is a set of unordered generic bullets, and 'validate outcomes' is a hand-wave with no validation checkpoint, command, or feedback loop for the synthesis process it asks Claude to perform. This matches anchor 2 (rough sequence at best, poorly defined steps, validation absent) and falls below anchor 3, which requires a listed step sequence.

2 / 5

Progressive Disclosure

Section headers (Containers, Interfaces, Dependencies, Infrastructure, etc.) provide real structure, but the single external reference 'resources/implementation-playbook.md' is buried in an Instructions bullet and does not exist in the bundle (no references/, scripts/, assets/, or resources/ directory), and substantial template content that could live in a separate file is fully inlined. This sits between anchor 2 (buried/broken references, inlined content) and anchor 4 (well-signaled, well-placed references).

3 / 5

Total

11

/

20

Passed

Description

32%Weight 40%Scale 1-5

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 is a role label rather than a capability description: it identifies a niche domain but provides no concrete actions, no trigger terms, and no 'use when' guidance. Its main strength is distinctiveness within the C4 model family; its main weaknesses are specificity and completeness.

Suggestions

Rewrite the description to list concrete actions, e.g. 'Create C4 container diagrams in Mermaid, document container APIs as OpenAPI specs, and map components to deployment units.'

Add an explicit 'when' clause with natural trigger phrases, e.g. 'Use when the user asks for container-level architecture, deployment diagrams, or container API documentation.'

Include natural synonyms and variations users would say ('container diagram', 'deployment architecture', 'C4 model') to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description 'Expert C4 Container-level documentation specialist' names the domain but contains no concrete actions whatsoever — it says nothing about what the skill actually does (create container diagrams, document APIs, map components to deployment units). It is not entirely generic (anchor 1) since the domain is specifically named, but it falls well short of anchor 3, which requires at least 1-2 concrete actions.

2 / 5

Completeness

The 'what' is vague ('documentation specialist' says little) and the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3 and pushes this to anchor 2. It is above anchor 1 because the domain is at least identified.

2 / 5

Trigger Term Quality

The only keyword present is 'C4 Container-level documentation'; there are no natural trigger phrases or variations a user might say ('container diagram', 'deployment architecture', 'C4 model'). Anchor 2 (one or two keywords, missing natural phrases) is the best fit; anchor 3 would require multiple relevant keywords with only synonyms missing.

2 / 5

Distinctiveness Conflict Risk

'C4 Container-level' names a specific, distinct layer of the C4 model, giving it a clear niche with only minor overlap risk against closely related sibling skills (C4 Component, Context, Code — which the body confirms exist). It is below anchor 5 because the lack of trigger phrases means sibling C4 skills are not explicitly differentiated in the description itself.

4 / 5

Total

10

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
sickn33/agentic-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.