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.

60

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

48%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 is well-grounded in concrete thresholds, formulas, and templates, and the phase workflow is coherent, but it reads as padded: usage narration, a duplicated When-to-Use section, and repeated threshold notes inflate the token cost while the actual counting mechanics remain non-executable. Restructuring into a lean core plus reference files would address both weaknesses.

Suggestions

Cut the 'Usage Examples' and 'When to Use' sections (they restate the description) and de-duplicate the 'Notes' thresholds against Phase 3 to roughly halve token cost.

Make the central counting step executable: give a concrete command or script for counting statements per component directory (e.g., a small cloc/grep-based recipe or a script in scripts/), instead of descriptive counting rules.

Move the output-format templates, fitness-function code, and per-language counting notes into reference files (references/output-templates.md, references/fitness-functions.md) and link them one level deep from a lean SKILL.md.

DimensionReasoningScore

Conciseness

The ~435-line body has several padded sections: "Usage Examples" narrates what "the skill will" do instead of instructing, "When to Use" restates the description, "Notes" repeats the Phase 3 thresholds, and the checklist re-iterates the phases. This matches anchor 2 (noticeably verbose, several unnecessary or padded sections); it is above anchor 1 because no space is spent explaining concepts Claude doesn't know.

2 / 5

Actionability

Concrete thresholds (>2 std dev, 10%/30%), exact formulas, output templates, and two runnable JS fitness functions are present, but the core operation — "Count executable statements (not comments, blank lines...)" and "Parse source files in component directory" — is described rather than executable, with no command or code that performs the counting. Matches anchor 3 (some concrete guidance but incomplete / pseudocode-level); anchor 4 would require the central steps to be executable too.

3 / 5

Workflow Clarity

A clear Phase 1→3 sequence with an explicit Analysis Checklist serving as a checkpoint; this is read-only analysis, so the destructive/batch validation cap does not apply. It falls short of anchor 5 because there are no validation checkpoints on outputs (e.g., verifying components' statements sum to the total or that leaf-node identification found no parents).

4 / 5

Progressive Disclosure

Headers give decent structure, but everything is inlined in one monolithic file: full output-format templates, fitness-function code, and per-language statement-counting notes would belong in reference files, and no bundle files exist to offload them. Matches anchor 3 (some structure, content that should be separate is inline); above anchor 2 because organization is not minimal, below anchor 4 because nothing is split out.

3 / 5

Total

12

/

20

Passed

Description

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

A strong description: concrete what-and-when structure, quoted natural trigger phrases with good synonym coverage, and an explicit negative boundary preventing mis-triggering. The only weakness is that it compresses the capability list to two actions, omitting the inventory/statistics/recommendations the body actually delivers.

Suggestions

Enumerate one or two more concrete actions (e.g., 'generates a component inventory with size statistics and split/consolidation recommendations') to lift specificity from two actions to several.

Consider adding a plain-language synonym such as 'codebase structure review' users might type instead of the quoted question forms.

DimensionReasoningScore

Specificity

Names the domain and two concrete actions ("Maps architectural components" and "measures their size to identify what should be extracted first") but stops short of covering the full capability set (inventory generation, statistics, recommendations). It fits anchor 3: 1-2 concrete actions, not comprehensive — below anchor 4, which expects several specific actions with only minor gaps.

3 / 5

Completeness

Explicitly answers both: what ("Maps architectural components in a codebase and measures their size to identify what should be extracted first") and when ("Use when asking... or planning where to start decomposing"), with concrete trigger phrases. This directly matches anchor 5 and exceeds anchor 4, whose 'when' is less explicit.

5 / 5

Trigger Term Quality

Quoted natural user phrasings — "how big is each module?", "what components do I have?", "which service is too large?", "analyze codebase structure", "size my monolith" — cover synonyms (module, component, service, monolith) users would actually say. Comprehensive coverage matches anchor 5; anchor 4's 'a few natural terms missing' does not apply given the breadth of variations.

5 / 5

Distinctiveness Conflict Risk

Clear niche (architectural component sizing for decomposition planning) with distinct triggers and an explicit negative boundary ("Do NOT use for runtime performance sizing or infrastructure capacity planning") that minimizes conflict with performance/capacity skills. Matches anchor 5; anchor 4's 'minor overlap risk' is superseded by the explicit do-not-use clause.

5 / 5

Total

18

/

20

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 — 16 / 16 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.