CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rate-complexity

Use when an issue needs its complexity declared — proposing a rating from the issue body alone and getting the owner to confirm or amend it, or backfilling a rating onto an existing unrated issue. Invoked by new-feat at issue-creation time; also the backfill path for issues opened before the label existed.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

80%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 executable and well-structured, with a genuinely instructive rubric and concrete gh commands. The main weakness is the batch backfill pass, which applies labels across many issues with no validation or error handling, capping workflow clarity.

Suggestions

Add a verification step to Mode B: after the pass, re-run the jq-filtered 'gh issue list' and report any issues still unrated, and confirm the six labels exist (e.g. 'gh label list') before batch-applying.

Specify error handling for the batch pass — what to do when a label is missing from the repo or a 'gh issue edit' call fails mid-listing.

Fix the duplicated repository in 'The labels' section — 'englishstreetventures/englishstreetventures.com' is named twice where two distinct repos appear to be intended.

DimensionReasoningScore

Conciseness

Mostly efficient: the body avoids explaining concepts Claude already knows, and the timing rationale carries genuinely non-obvious domain rules. A few rhetorical passages ('the number gets talked into agreeing with the spend, and the metric quietly starts confirming whatever already happened') could be trimmed, holding it at 4 rather than 5; it stays above 3 because padding is minor and localized.

4 / 5

Actionability

Copy-paste-ready commands for both modes ('gh issue edit … --add-label "complexity:3"'), a concrete jq-filtered listing for the backfill pass, an explicit Fibonacci rubric table, and exact label names. Specific examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Mode A is clearly sequenced with an owner-confirmation checkpoint and an unattended-run fallback, but Mode B is a batch operation — one pass applying labels to up to 200 issues — with no verification step (no check that the six labels exist, no post-apply confirmation, no error handling). Per the batch-operation cap, workflow clarity cannot exceed 3; it is above 2 because both modes' sequences are otherwise well defined.

3 / 5

Progressive Disclosure

A single self-contained file with clear sections, a small inline rubric table and label table that belong inline at this size, and well-signaled one-level-deep external pointers ('wiki/conventions/session-metrics.md', '@tools/pr-metrics'). No bundle files are needed and navigation is easy, matching the 5 anchor.

5 / 5

Total

17

/

20

Passed

Description

87%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: explicit trigger clause, concrete actions in third-person voice, and a well-delineated niche. The only soft spot is keyword coverage, which omits common synonyms like 'difficulty' or 'estimate'.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'proposing a rating from the issue body alone', 'getting the owner to confirm or amend it', 'backfilling a rating onto an existing unrated issue' — with only minor gaps (the label-application step is implied rather than stated). It sits at 4 rather than 5 because coverage is not comprehensive, and above 3 because it names the domain plus three specific actions rather than one or two.

4 / 5

Completeness

It explicitly answers both halves: 'Use when an issue needs its complexity declared' gives the when with concrete trigger phrases, and the rest states clearly what the skill does (propose, confirm/amend, backfill). Both are explicit and concrete, matching the 5 anchor rather than the 4 anchor's 'when could be more specific'.

5 / 5

Trigger Term Quality

Natural terms a user would say are present: 'complexity', 'rating', 'issue', 'backfill', 'unrated', 'confirm or amend'. A few natural synonyms are missing ('difficulty', 'estimate', 'triage', 'size'), which holds it at 4 rather than 5; it is above 3 because keyword coverage is good rather than missing common variations.

4 / 5

Distinctiveness Conflict Risk

A clear niche — declaring issue-complexity labels at issue-creation or backfill time — with distinct triggers and no meaningful overlap with generic triage or code-review skills. The repeated anchoring on 'issue', 'rating', and 'complexity' keeps conflict risk minimal, matching the 5 anchor.

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

englishstreetventures/englishstreetventures.com

Path

.claude/skills/rate-complexity/SKILL.md

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.