CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/skill-matrix-author

Use when a QA manager needs to know what the team can do today versus what its projects demand, before quarterly planning, a training budget decision or opening a role. Builds an evidence-backed skill matrix, classifies and ranks gaps and recommends train, hire or bring in an expert per gap.

Quality

92%

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

Overview
Quality
Evals
Security
Files

Quality

Content

88%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-engineered procedural skill: concrete, sequenced, and guarded by explicit halt conditions and validation rules, with a verified one-level-deep worked example in the bundle. Its main costs are token-level redundancy (the inventory-vs-gap point and the evidence rule each stated several times) and long syllabus quotations inlined in SKILL.md.

Suggestions

State the "matrix without demand is only an inventory" principle once (e.g., in the Overview) and cross-reference it from Step 5, Step 7a, and the Anti-patterns entry instead of restating it each time.

Consolidate the self-assessment evidence rule into Step 3 and reference it from the Step 7 guardrails and the Anti-patterns table rather than repeating it in three places.

Move the extended CTAL-TM quotation blocks (Steps 2, 3, and 6) into a syllabus-extracts reference file, keeping one-line citations inline, to reduce SKILL.md token load while preserving the evidence trail.

DimensionReasoningScore

Conciseness

The body is dense with operational content (halt codes, column-count limits, evidence rules) and avoids explaining concepts Claude already knows, but key points repeat: "supply without demand is an inventory" appears in the Overview, Step 5, Step 7a, and the Anti-patterns table, and the self-assessment evidence rule is stated in Step 3, the Step 7 guardrails, and Anti-patterns. Not 5 because these repetitions and the long inline CTAL-TM quotation blocks could be trimmed; not 3 since the padding is minor rather than a pattern of unnecessary explanation.

4 / 5

Actionability

Fully executable guidance for an instruction-only skill: an input table with a halt condition, a 0-3 proficiency scale with minimum evidence per level, a copy-paste markdown matrix template with footnotes, a four-class gap taxonomy, explicit ranking criteria in 7b, conditional train/hire/expert heuristics in 7c, and a five-section report specification with filename pattern in 7d. Specific examples (the minimal matrix shape, the perf bus-factor case) cover the common cases.

5 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced with explicit validation checkpoints (MISSING_REQUIRED_SKILLS_CONTEXT in Step 1, MISSING_DEMAND_INPUT in 7a) and feedback loops ("fix the matrix first and name the offending cells", mark stale matrices and recommend re-assessment). The Anti-patterns table and Step 7 guardrails act as checklists, matching the top anchor.

5 / 5

Progressive Disclosure

The single bundle file (references/skill-matrix-example.md) is real, clearly signaled in Step 4 with a proper link, and one level deep — but the ~175-line body inlines extended CTAL-TM quotation blocks and a full reference-list citation that could live in a references file, and only one bundle file exists. Good structure with minor organization gaps fits anchor 4 rather than 5; it is above 3 because what is inline is mostly the workflow itself, appropriately so.

4 / 5

Total

18

/

20

Passed

Description

92%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: third-person voice, explicit "Use when" triggers tied to real managerial moments, and a concrete multi-action statement of what the skill produces. The only weakness is modest synonym coverage for terms users might naturally say.

DimensionReasoningScore

Specificity

The description lists multiple concrete, comprehensive actions — "Builds an evidence-backed skill matrix, classifies and ranks gaps and recommends train, hire or bring in an expert per gap" — covering the skill's full output surface. It is not score 4 because there is no meaningful gap in action coverage; it is not below 5 since every named action is concrete rather than generic.

5 / 5

Completeness

Both questions are answered explicitly: "Use when a QA manager needs to know what the team can do today versus what its projects demand, before quarterly planning, a training budget decision or opening a role" gives concrete when-triggers, and the second sentence gives a clear what with specific actions. Score 4 would require the when to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "QA manager", "quarterly planning", "training budget decision", "opening a role", "skill matrix" — phrased the way the target user would say them. It falls short of 5 because common variations such as "skills gap analysis", "competency assessment", or "team capability" are absent.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (QA team capability planning) with distinct triggers (QA manager, quarterly planning, training budget, skill matrix) and would not plausibly fire for unrelated skills. Minor adjacency to a hiring skill exists but the description scopes itself to team capability, not candidate scoring.

5 / 5

Total

19

/

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.

Reviewed

On this page