CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

c4-context

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

1.34x
Quality

57%

Does it follow best practices?

Impact

97%

1.34x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/c4-context/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

32%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 has a usable skeleton (Mermaid C4 syntax example, sectioned documentation template, key principles), but it is padded with circular and generic filler, offers no worked example, and its only progressive-disclosure pointer targets a file that does not exist. Tightening the filler and either providing or removing the broken reference are the highest-impact fixes.

Suggestions

Fix the progressive-disclosure pointer: either create resources/implementation-playbook.md (or move it to references/) with a worked, filled-in example, or remove the reference — currently the promised detail is unreachable.

Delete or rewrite the tautological "Use this skill when" / "Do not use this skill when" and generic "Instructions" sections; replace them with a short, ordered workflow (gather inputs → draft personas/features → map journeys → draft Mermaid diagram → verify all personas and external systems appear in the diagram).

Remove the redundancy: "Output Examples" restates the template and "Key Principles" repeats the section intro; consolidate into one section, and remove the stray unmatched ``` fence after "Related Documentation".

Add one small concrete worked example (a single filled-in persona and a three-step journey) so the placeholder template is grounded in real content.

DimensionReasoningScore

Conciseness

Several padded sections: "Use this skill when" / "Do not use this skill when" are circular restatements of the title ("Working on c4 context level: system context tasks or workflows"), "Instructions" is generic filler ("Clarify goals, constraints, and required inputs"), "Key Principles" repeats the intro paragraph of the same section, and "Output Examples" restates the template sections nearly verbatim. Not a 3: the padding is substantial rather than incidental; not a 1: the Mermaid template and structural skeleton earn their place.

2 / 5

Actionability

Concrete elements exist — the Mermaid C4Context example with valid syntax and the sectioned documentation template — but the template is placeholder-only ([Persona Name], [Step 1]: [Description]) with no worked example, the "Instructions" steps are abstract, and the pointer "If detailed examples are required, open resources/implementation-playbook.md" targets a file that does not exist in the bundle. Not a 4 because the promised detailed examples are unreachable and no filled-in example demonstrates the expected output; not a 2 because the Mermaid block and template skeleton give real, usable structure.

3 / 5

Workflow Clarity

No real process is sequenced: the body is a template plus principles, and the only sequence-like content ("Clarify goals... Apply relevant best practices and validate outcomes... Provide actionable steps and verification") is a vague three-line gesture with no checkpoints or error handling. Not a 3 because even the implicit sequence (gather inputs → draft sections → diagram) is never stated as ordered steps; not a 1 because the template's section order and the Key Principles do impose a rough logical progression. The documentation-generation task is not destructive/batch, so the hard validation cap is not triggered.

2 / 5

Progressive Disclosure

The bundle contains no reference files at all, and the single external pointer — "open resources/implementation-playbook.md" — references a nonexistent path, so navigation fails in practice (there is a stray unmatched ``` fence at the end of "Related Documentation" as well). Not a 3: a broken-to-nonexistent reference is worse than a present-but-unclearly-signaled one, and the ~60-line placeholder template is inlined where a worked example in a reference file would be the appropriate split; not a 1: the body itself has clear section headers and is not an unnavigable wall of text or multi-level reference chain.

2 / 5

Total

9

/

20

Passed

Description

66%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 communicates concrete capabilities with good domain keywords, but it completely lacks a "when to use" trigger clause, which caps its completeness and limits discovery. Adding an explicit "Use when..." sentence with trigger phrases would move it to the top tier.

Suggestions

Add a trigger clause, e.g.: "Use when creating C4 system context documentation, mapping personas and user journeys, or when the user mentions C4 context diagrams, system context, or architecture overviews."

Trim the "Expert ... specialist" role framing and fold in output cues (e.g., Mermaid diagrams) to sharpen specificity.

Include common synonyms such as "C4 model", "system landscape", or "architecture overview" to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

"Creates high-level system context diagrams, documents personas, user journeys, system features, and external dependencies" lists several concrete actions covering the domain. Not a 5: the actions are all documentation-verbs with minor gaps (no format/tool cues like Mermaid), and "Expert C4 Context-level documentation specialist" is a role claim rather than an action; not a 3 since coverage clearly exceeds 1-2 actions.

4 / 5

Completeness

The "what" is clear (creates context diagrams and documents personas, journeys, features, dependencies), but there is no "when" — no "Use when..." clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. Not a 4 because the "when" is entirely absent rather than merely weak.

3 / 5

Trigger Term Quality

Natural domain keywords are present: "C4 Context-level", "system context diagrams", "personas", "user journeys", "external dependencies" — phrases a user would plausibly say. Not a 5: misses common variations like "C4 model", "architecture overview", "system landscape"; not a 3 because coverage goes well beyond one or two generic keywords.

4 / 5

Distinctiveness Conflict Risk

"C4 Context-level" names a clear niche (the context level of the C4 model) that is distinct from general documentation skills. Not a 5: it does not differentiate from sibling C4-level skills (container/component/code), so a request for "C4 documentation" broadly could trigger it; not a 3 because the scope-level qualifier keeps overlap limited.

4 / 5

Total

15

/

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

plugins/AI-Agents-Safe-Coding-Skills/skills/c4-context/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.