c4-code

Expert C4 Code-level documentation specialist. Analyzes code directories to create comprehensive C4 code-level documentation including function signatures, arguments, dependencies, and code structure. Use when documenting code at the lowest C4 level for individual directories and code modules.

Quality

53%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./docs/v19.7/configuration/agent/skills_external/antigravity-awesome-skills-main/skills/c4-code/SKILL.md

Quality

Content

22%

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

This skill is primarily a documentation template rather than actionable guidance for Claude. It explains C4 concepts and Mermaid diagram syntax that Claude already knows, while lacking concrete steps for actually analyzing code directories. The extensive diagram examples and comparison tables add significant token overhead without providing the workflow clarity needed for Claude to execute this task effectively.

Suggestions

Replace the generic 4-bullet instruction list with a concrete workflow: 1) List files in directory, 2) Extract function signatures using specific patterns, 3) Identify dependencies by analyzing imports, 4) Generate documentation in template format

Remove the extensive Mermaid diagram tutorials and 'Choosing the Right Diagram' table - Claude knows Mermaid syntax. Instead, just specify 'Use classDiagram for OOP, flowchart for FP pipelines'

Add validation steps: how to verify the documentation is complete, how to check that all public functions are documented, how to validate dependency lists

Move the template structure to a separate reference file and keep SKILL.md focused on the analysis workflow and decision points

Dimension	Reasoning	Score
Conciseness	The content is extremely verbose with extensive template placeholders, multiple diagram options with full examples, and explanatory tables. Much of this (Mermaid syntax, diagram types, C4 model concepts) is knowledge Claude already possesses and doesn't need to be taught.	1 / 3
Actionability	Provides template structure and diagram examples, but the actual instructions are vague ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices'). The code examples are templates with placeholders rather than executable guidance for analyzing real code.	2 / 3
Workflow Clarity	No clear workflow for how to actually analyze a codebase and produce C4 documentation. The instructions section has only four bullet points of generic advice. Missing: how to traverse directories, what to extract, validation steps, iteration process.	1 / 3
Progressive Disclosure	References 'resources/implementation-playbook.md' for detailed examples, which is appropriate. However, the main file contains too much inline content (full diagram examples, comparison tables) that should be in reference files, making the skill bloated.	2 / 3
	Total	6 / 12 Passed

Description

85%

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 a strong skill description that clearly defines its specialized niche in C4 code-level documentation. It excels at specificity and completeness with an explicit 'Use when' clause. The main weakness is trigger term coverage - it relies heavily on users knowing C4 terminology rather than including natural language variations for code documentation needs.

Suggestions

Add natural language trigger terms users might say, such as 'document my code', 'code documentation', 'API docs', or 'module documentation'

Include common file/language references that might trigger this skill, such as 'source files', 'codebase documentation', or specific language mentions

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'Analyzes code directories', 'create comprehensive C4 code-level documentation', 'function signatures, arguments, dependencies, and code structure'. These are concrete, actionable capabilities.	3 / 3
Completeness	Clearly answers both what ('Analyzes code directories to create comprehensive C4 code-level documentation including function signatures, arguments, dependencies, and code structure') AND when ('Use when documenting code at the lowest C4 level for individual directories and code modules').	3 / 3
Trigger Term Quality	Includes some relevant terms like 'C4', 'code-level documentation', 'function signatures', 'dependencies', but misses common variations users might say like 'document my code', 'code docs', 'API documentation', or file extensions.	2 / 3
Distinctiveness Conflict Risk	Very specific niche targeting 'C4 Code-level' documentation specifically, distinguishing it from general documentation skills or higher-level C4 diagrams (context, container, component). The 'lowest C4 level' phrase creates clear boundaries.	3 / 3
	Total	11 / 12 Passed

Validation

90%

Warnings & errors only

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

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	10 / 11 Passed

Repository: duclm1x1/Dive-Ai
Commit: 20ba150

Reviewed: 4 months ago

Table of Contents

Discovery Implementation Validation

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.