CtrlK
BlogDocsLog inGet started
Tessl Logo

ac-complexity-assessor

Assess feature and project complexity. Use when estimating effort, determining spec pipeline type, calculating cost estimates, or planning resource allocation.

60

Quality

75%

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 ./.claude/skills/ac-complexity-assessor/SKILL.md

The canonical home for this skill is ac-complexity-assessor in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured reference document with verified executable Quick Start code and appropriate offloading of implementation detail to the bundle script. Its weaknesses are padded generic sections (Complexity Factors), a cost formula with undefined constants, and the absence of an explicit usage workflow tying assessment output to pipeline selection.

Suggestions

Delete the 'Complexity Factors' section and the redundant 'Purpose' section; their generic bullet lists (e.g. 'Implementation difficulty', 'Unfamiliar technologies') restate knowledge Claude already has.

Give the cost-estimation constants real values or state where they are defined in complexity_assessor.py, so the formula is actually computable.

Add a short usage workflow (assess_project -> interpret metrics -> select pipeline -> optionally assess_feature for hot spots) so the sequence from assessment to action is explicit.

DimensionReasoningScore

Conciseness

The body is mostly tables and code with little prose padding, but the 'Purpose' section restates the description and the 'Complexity Factors' section lists generic nouns ("Implementation difficulty", "Unfamiliar technologies", "Complex algorithms") that add no information Claude does not already have. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, where only minor instances of over-explanation would remain.

3 / 5

Actionability

The Quick Start is executable and verified against the real script API (ComplexityAssessor(project_dir), await assessor.assess_project()), and the Assessment Output JSON shows concrete field names. The cost formula is the one gap: it references undefined constants (avg_tokens_per_feature, session_overhead, complexity_multiplier) with no values or source. Mostly executable guidance with minor gaps matches anchor 4 rather than anchor 3, since the primary path is fully runnable.

4 / 5

Workflow Clarity

Pipeline phase sequences are clearly listed, but there is no end-to-end usage workflow: no guidance on when to use assess_feature vs assess_project, how to interpret the metrics to select a pipeline, or how to handle edge cases, and no validation checkpoints anywhere. Steps listed with implicit or missing checkpoints matches anchor 3, not anchor 4 ('most checkpoints present').

3 / 5

Progressive Disclosure

The 15KB implementation correctly lives in scripts/complexity_assessor.py and is referenced one level deep ("See `scripts/complexity_assessor.py` for full implementation"), with the Quick Start import path matching the real bundle file. This is good structure with appropriately placed content, but the single reference is a plain pointer at the bottom rather than clearly signaled per-section links, keeping it at anchor 4 instead of the well-signaled navigation of anchor 5.

4 / 5

Total

14

/

20

Passed

Description

78%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 that explicitly covers both what the skill does and when to use it, with natural trigger phrases for effort estimation, pipeline selection, cost estimation, and resource planning. The main weakness is that the capability side ('assess complexity') stays abstract while the trigger side carries the specificity.

Suggestions

Enumerate the concrete capabilities in the what-clause (e.g. 'Analyze feature dependency graphs, score complexity levels, select SIMPLE/STANDARD/COMPLEX pipelines, and produce effort and cost estimates') to lift specificity.

Add common user synonyms such as 'sizing', 'effort hours', or 'how long will this take' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

"Assess feature and project complexity" names the domain with one concrete action, and the when-clause adds four specific tasks, but the capability list on the what-side is not comprehensive beyond 'assess'. This matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' rather than anchor 4, which expects several specific listed actions.

3 / 5

Completeness

Explicitly answers both what ("Assess feature and project complexity") and when ("Use when estimating effort, determining spec pipeline type, calculating cost estimates, or planning resource allocation") with concrete trigger phrases. This clearly matches the anchor-5 example pattern of a clear what followed by an explicit 'Use when' clause with concrete triggers.

5 / 5

Trigger Term Quality

Phrases like "estimating effort", "calculating cost estimates", and "planning resource allocation" are natural terms users would say when needing this skill, though common variations (e.g. 'how long will this take', 'effort sizing') are missing. Good coverage with a few natural terms missing matches anchor 4, not the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The combination of complexity assessment, spec pipeline type, and cost estimation carves a fairly distinct niche, but the description could still overlap with generic planning or estimation skills. Mostly distinct with minor overlap risk against closely related skills matches anchor 4 rather than the clear-niche anchor 5.

4 / 5

Total

16

/

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
fernandezbaptiste/Skrillz
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.