CtrlK
BlogDocsLog inGet started
Tessl Logo

component-identification-sizing

Maps architectural components in a codebase and measures their size to identify what should be extracted first. Use when asking "how big is each module?", "what components do I have?", "which service is too large?", "analyze codebase structure", "size my monolith", or planning where to start decomposing. Do NOT use for runtime performance sizing or infrastructure capacity planning.

71

Quality

63%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./packages/skills-catalog/skills/(architecture)/component-identification-sizing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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 an excellent skill description that hits all the marks. It provides specific concrete actions, includes a rich set of natural trigger terms users would actually say, clearly delineates both what the skill does and when to use it, and even includes negative triggers to prevent misuse. The 'Do NOT use' clause is a particularly strong addition for distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Maps architectural components', 'measures their size', 'identify what should be extracted first'. These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (maps architectural components, measures size, identifies extraction priorities) and 'when' (explicit 'Use when' clause with multiple trigger phrases). Also includes a 'Do NOT use' clause for disambiguation.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: 'how big is each module', 'what components do I have', 'which service is too large', 'analyze codebase structure', 'size my monolith', 'decomposing'. These are phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche around codebase architectural analysis and module sizing. The 'Do NOT use' clause explicitly excludes runtime performance and infrastructure capacity planning, reducing conflict risk with related skills.

3 / 3

Total

12

/

12

Passed

Implementation

27%

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

This skill is comprehensive in coverage but severely over-engineered for a SKILL.md file. It explains concepts Claude already understands (standard deviation, what components are, how to count statements in various languages), repeats threshold information multiple times, and packs everything into a single monolithic document. The content would benefit enormously from being condensed to a lean overview with references to separate files for language-specific details, output templates, and fitness functions.

Suggestions

Reduce the document to ~80 lines by removing explanations of basic concepts (standard deviation formula, what a component is, how statements work in each language) and consolidating repeated threshold information into a single concise table.

Extract language-specific implementation notes, fitness function code, and detailed output format templates into separate referenced files (e.g., LANGUAGES.md, FITNESS_FUNCTIONS.md, OUTPUT_TEMPLATES.md).

Replace the abstract 'Usage Examples' section (which just lists what the skill 'will do') with a single concrete example showing actual input directory structure and the resulting output table.

Add explicit validation checkpoints between phases, such as 'Verify all leaf nodes are identified before calculating metrics' and 'Cross-check total statement count against file counts for sanity' to strengthen the workflow.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines. It explains basic concepts Claude already knows (what a component is, how standard deviation works, what statements are in different languages), repeats information across sections (thresholds mentioned 3+ times), and includes extensive output format templates that could be much more concise. The 'Usage Examples' section describes what the skill will do rather than providing actionable content.

1 / 3

Actionability

The skill provides some concrete guidance like the fitness function code examples and the output table format, but much of the content describes processes abstractly ('scan the codebase directory structure') rather than providing executable commands or code. The statement counting guidance is descriptive rather than providing actual parsing code. The 'Usage Examples' just list what the skill 'will do' rather than showing concrete execution.

2 / 3

Workflow Clarity

The three-phase process (Identify, Calculate, Assess) is clearly sequenced and the checklist at the end is helpful. However, there are no validation checkpoints or feedback loops - no step says 'verify your component identification is complete before proceeding to sizing' or handles error cases like ambiguous directory structures. For a multi-step analytical process, the lack of verification steps between phases is a gap.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no references to external files. The implementation notes for different languages, fitness functions, output format templates, and best practices could all be split into separate reference files. Everything is inline in one massive document, making it hard to navigate and consuming excessive context window space.

1 / 3

Total

6

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tech-leads-club/agent-skills
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.