Generate comprehensive C4 architecture documentation for an existing repository/codebase using a bottom-up analysis approach.
Install with Tessl CLI
npx tessl i github:sickn33/antigravity-awesome-skills --skill c4-architecture-c4-architectureOverall
score
68%
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
32%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 identifies a specific methodology (C4) and approach (bottom-up analysis) which provides some clarity, but it lacks explicit trigger guidance and comprehensive action verbs. The absence of a 'Use when...' clause significantly weakens its utility for skill selection among many options.
Suggestions
Add a 'Use when...' clause with trigger terms like 'C4 diagrams', 'architecture documentation', 'document codebase structure', 'system context diagram', 'container diagram'
List specific concrete actions such as 'analyze code structure, generate context diagrams, create container and component views, produce deployment diagrams'
Include file type triggers like '.md architecture files', 'PlantUML', or 'Structurizr DSL' if applicable to increase distinctiveness
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (C4 architecture documentation) and mentions a specific approach (bottom-up analysis), but doesn't list concrete actions like 'create context diagrams, generate container views, map component relationships'. | 2 / 3 |
Completeness | Describes what it does (generate C4 documentation) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes some relevant terms like 'C4', 'architecture documentation', 'codebase', and 'repository', but misses common variations users might say like 'system diagrams', 'architecture diagrams', 'code structure', or 'document my code'. | 2 / 3 |
Distinctiveness Conflict Risk | The C4 methodology reference provides some distinctiveness from generic documentation skills, but 'architecture documentation' could overlap with other documentation or diagramming skills without clearer boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured workflow skill with excellent actionability and clear phase sequencing. The main weaknesses are verbosity (extended thinking block, C4 model explanations) and the monolithic structure that could benefit from splitting detailed prompts into separate files. The success criteria provide good validation checkpoints.
Suggestions
Remove the extended thinking block and C4 model explanations - Claude already knows what C4 is
Move the detailed prompts for each phase into separate reference files (e.g., prompts/code-level.md) and reference them from the main skill
Remove the generic 'Use this skill when' and 'Do not use this skill when' sections that add no value
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains some unnecessary verbosity, including an extended thinking block that adds no value, explanations of what C4 is (Claude knows this), and repetitive structure descriptions. However, the core workflow content is reasonably efficient. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance with specific prompts for each phase, exact file naming conventions, clear output structures, and executable examples. The Task tool usage with subagent_type specifications is copy-paste ready. | 3 / 3 |
Workflow Clarity | The four-phase workflow is clearly sequenced with explicit dependencies between phases. Each phase has numbered steps, clear inputs/outputs, and the success criteria section provides validation checkpoints. The bottom-up processing order is explicitly stated. | 3 / 3 |
Progressive Disclosure | The skill references an external file (resources/implementation-playbook.md) but the main content is a monolithic document with all phases inline. The output structure section helps, but the detailed prompts for each phase could be split into separate reference files. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Table of Contents
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.