CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

c4-component

Expert C4 Component-level documentation specialist. Synthesizes C4 Code-level documentation into Component-level architecture, defining component boundaries, interfaces, and relationships.

3.12x
Quality

60%

Does it follow best practices?

Impact

100%

3.12x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/c4-component/SKILL.md

The canonical home for this skill is c4-component in sickn33/agentic-awesome-skills

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 skill provides a usable documentation template with a valid Mermaid C4Component example and helpful distinctions from sibling C4 levels, but it lacks any concrete workflow for performing the synthesis and defers its methodology to a playbook file that is missing from the bundle. Generic boilerplate sections pad the body without adding C4-specific value.

Suggestions

Replace the generic Instructions with a numbered workflow: read all c4-code-*.md files for the target container, group code elements into logical components with rationale, define each component's interfaces and dependencies, render the Mermaid C4Component diagram, then update the Master Component Index — with a validation step such as verifying every c4-code-*.md file is linked from exactly one component.

Fix the dangling reference: 'resources/implementation-playbook.md' does not exist in the bundle; either create the playbook (ideally under references/) or remove the pointer so the skill is self-contained.

Move the Master Component Index Template into a reference file and strip the boilerplate 'Use this skill when' / 'Do not use this skill when' / Instructions sections, keeping SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The Mermaid C4Component example and Key Distinctions section earn their tokens, but generic filler sections ('Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes.', 'Provide actionable steps and verification.') and the boilerplate 'Use this skill when' / 'Do not use this skill when' sections are unnecessary padding that could be tightened.

3 / 5

Actionability

The documentation template fields and the executable Mermaid C4Component example are concrete, but the core synthesis methodology is deferred to 'resources/implementation-playbook.md', which does not exist in the bundle, leaving key details missing. The Instructions section offers only vague direction rather than specific steps.

3 / 5

Workflow Clarity

There is no actual sequence for the synthesis process (e.g., read all c4-code-*.md files, group into logical components, define interfaces, render the diagram, update the master index). The Instructions bullets form only a vague pseudo-sequence with no checkpoints or validation. Not score 3 because there is not even a listed step sequence whose validation gaps could be evaluated.

2 / 5

Progressive Disclosure

The body has clear section headers and is navigable, but its only external reference, 'resources/implementation-playbook.md', is a dangling pointer — no bundle file exists at that path (no references/, scripts/, or assets/ directories are present). The full Master Component Index Template is also inlined where a separate reference file would be appropriate.

3 / 5

Total

11

/

20

Passed

Description

58%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 clearly states what the skill does with several concrete actions and sits in a well-defined C4 niche, but it omits any explicit 'when to use' trigger guidance and lacks natural trigger synonyms. Third-person voice is used correctly throughout.

Suggestions

Add an explicit trigger clause, e.g. 'Use when creating C4 component diagrams, synthesizing c4-code-*.md files into component-level documentation, or defining component boundaries and interfaces.'

Include natural synonyms and variations users would actually say: 'component diagram', 'C4 model', 'component architecture'.

Drop the 'Expert ... specialist' filler and instead name the concrete outputs (component documentation pages, Mermaid C4Component diagrams, master component index).

DimensionReasoningScore

Specificity

'Synthesizes C4 Code-level documentation into Component-level architecture, defining component boundaries, interfaces, and relationships' lists several specific actions (synthesize, define boundaries, interfaces, relationships), though 'Expert ... documentation specialist' is filler and output artifacts like diagrams and index files go unmentioned. Not 5 because coverage has minor gaps; not 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

The 'what' is clear (synthesizes code-level documentation into component-level architecture with boundaries, interfaces, and relationships), but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3. Not 4 because the trigger guidance is missing outright, not merely imprecise.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ('C4', 'Component-level', 'Code-level', 'architecture', 'boundaries', 'interfaces') but common natural variations users would say — 'component diagram', 'C4 model', 'Structurizr' — are missing, and there is no 'Use when' phrasing to surface natural triggers. Not 4 because a few natural terms are missing rather than merely one or two.

3 / 5

Distinctiveness Conflict Risk

'C4 Component-level' carves a mostly distinct niche, and 'Synthesizes C4 Code-level documentation' explicitly positions it against the code level, leaving only minor overlap risk with sibling C4 skills (c4-code, c4-container, c4-context) and with generic 'component' work (e.g., UI components). Not 5 because the description does not fully disambiguate from the container/context levels and 'component' is an overloaded term.

4 / 5

Total

14

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/c4-component/SKILL.md

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.