CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

c4-architecture-c4-architecture

Generate comprehensive C4 architecture documentation for an existing repository/codebase using a bottom-up analysis approach.

1.60x
Quality

60%

Does it follow best practices?

Impact

98%

1.60x

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-architecture-c4-architecture/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

50%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.

A well-structured, highly concrete multi-agent workflow with detailed subagent prompts and clear sequencing, but it is padded with boilerplate and triple-redundant summaries, lacks validation checkpoints between phases for a batch operation, and its only file reference is broken.

Suggestions

Delete the boilerplate sections ('Use this skill when', 'Do not use this skill when', '[Extended thinking:]', the generic 'Instructions' bullets, and the 'Example Usage' section) — together they duplicate the Overview and Coordination Notes.

Add explicit validation checkpoints between phases, e.g. after Phase 1 verify every subdirectory has a c4-code-*.md file before synthesis, and after Phase 3 verify every container API has an OpenAPI spec.

Fix or remove the broken reference to `resources/implementation-playbook.md` (the file does not exist), or actually ship it; consider moving the four large subagent prompt templates into reference files to shorten SKILL.md.

DimensionReasoningScore

Conciseness

The core phase prompts earn their place, but there are several padded sections: the circular 'Use this skill when/Do not use this skill when' boilerplate ('Working on c4 architecture documentation workflow tasks or workflows'), the '[Extended thinking:]' restatement, the generic 'Instructions' bullet filler, and the workflow being summarized three times (Overview, Coordination Notes, Example Usage). Matches anchor 2 ('Noticeably verbose; several unnecessary... padded sections'); not 3 because the duplication and boilerplate go beyond 'could be tightened'.

2 / 5

Actionability

Each phase gives concrete Task tool invocations (subagent_type="c4-architecture::c4-code" etc.) with full prompt templates, exact output file paths, and naming conventions — mostly executable guidance. Not 5: minor gaps remain, notably the reference to `resources/implementation-playbook.md` which does not exist in the bundle, reliance on subagent types without any fallback if unavailable, and placeholder-only examples.

4 / 5

Workflow Clarity

The four-phase sequence is clearly ordered (deepest-first bottom-up, numbered subsections, success criteria checklist, output structure), which would rate 4 — but this is a batch operation over every subdirectory with no per-phase validation checkpoints or feedback loops (no 'verify all c4-code-*.md exist before synthesis' step, no error recovery), capping workflow clarity at 3 per the rubric's batch-operation guidance. Not 2: sequence and expected outputs per phase are explicit.

3 / 5

Progressive Disclosure

Section headers are clear and the skill is navigable, but everything is inlined: the ~240 lines of subagent prompt templates are content that could be split into reference files, and the single external reference (`resources/implementation-playbook.md`, line 30) points to a file that does not exist. Matches anchor 3 ('Some structure but could be better organized'); not 4 because there is no functioning one-level-deep reference — the only one is broken.

3 / 5

Total

12

/

20

Passed

Description

53%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 concise and names a distinctive, well-defined domain, but it is a single 'what' sentence. It lacks any 'when to use' trigger guidance (capping completeness), omits natural trigger synonyms like 'diagram' or 'C4 model', and lists only one concrete action.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for C4 diagrams, architecture diagrams, or system documentation for a codebase.'

Include natural synonyms and variations users say: 'diagrams', 'C4 model', 'context diagram', 'container diagram', 'architecture documentation'.

Enumerate the concrete deliverables (code-level docs per directory, component synthesis, container map with OpenAPI specs, context diagram with personas) instead of the single generic verb 'generate'.

DimensionReasoningScore

Specificity

"Generate comprehensive C4 architecture documentation for an existing repository/codebase using a bottom-up analysis approach" names a precise domain and one concrete action (generate documentation) with a method qualifier (bottom-up), but does not list multiple specific actions. Not 4: unlike 'Lists several specific actions', only a single action is stated; not 2: the domain is specific and the action is concrete rather than generic.

3 / 5

Completeness

Has a clear 'what' (generate C4 architecture documentation bottom-up) but no 'Use when...' clause or equivalent trigger guidance anywhere, which caps completeness at 3 per the judging guidelines. Not 4: the 'when' is entirely missing, not merely implicit or underspecified.

3 / 5

Trigger Term Quality

Contains the key natural term 'C4 architecture' plus 'documentation', 'repository', 'codebase', but misses common variations users would say such as 'diagram', 'C4 model', 'context/container/component diagram', or 'software architecture'. Anchor 3 ('Some relevant keywords but missing common variations or synonyms') fits; not 4 because the most natural trigger word for C4 work ('diagram') is entirely absent.

3 / 5

Distinctiveness Conflict Risk

"C4 architecture documentation" is a clear niche with low conflict risk against generic documentation or code-review skills. Not 5: the rubric's 5-anchor examples pair the niche with explicit trigger phrases, which this description lacks, so distinctiveness rests solely on the domain term; not 3: the C4 model reference is far more specific than 'Works with document files'.

4 / 5

Total

13

/

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-architecture-c4-architecture/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.