CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/skill-matrix-author

Build-an-X workflow that produces a QA team skill matrix - team members crossed with competency dimensions at explicit proficiency levels, each cell backed by observable evidence - then derives the full gap analysis: classify each gap (coverage / capability / bus-factor / surplus), rank the gaps against the team's roadmap, and recommend a closing move per gap (train / peer-learn vs hire vs external expert). Competency dimensions follow ISTQB CTAL-TM v3.0 chapter 3 (Managing the Team): professional, methodological, social, and personal competence. Maps the existing team on an ongoing basis - not a point-in-time score of external candidates and not one new hire's ramp plan. 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 requisition.

75

Quality

94%

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

92%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 process skill: every step carries concrete thresholds, gates, and output templates, with real validation checkpoints (halt codes, evidence rules, staleness checks) and the worked example properly split into a one-level-deep reference file that exists in the bundle. The only weakness is moderate rhetorical repetition of the inventory-vs-gap-analysis point and some trimmable citation apparatus.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, load-bearing rules (evidence gates, column-count ceilings, halt codes, ranking keys) and never explains generic concepts, but the 'matrix alone is an inventory' point is stated four times (Overview, Step 7 intro, Step 7a, Anti-patterns) and academic attribution asides ('after Sonntag & Schmidt-Rathjens 2005 and Erpenbeck & von Rosenstiel 2017') could be trimmed. This sits between level 3 ('some unnecessary explanation') and level 5 ('every token earns its place'), matching level 4: efficient with minor trimmable instances.

4 / 5

Actionability

Fully executable for an instruction-only skill: a concrete 0-3 proficiency table with per-level minimum evidence, a literal markdown matrix template with team-need row and footnote convention, named halt codes (MISSING_REQUIRED_SKILLS_CONTEXT, MISSING_DEMAND_INPUT), explicit ranking criteria (roadmap proximity > gap class > blast radius), and a five-part report template with a filename pattern. Per the rubric's instruction-skill note, absence of code is not penalized when guidance is this specific; it exceeds level 4 ('minor gaps').

5 / 5

Workflow Clarity

Steps 1-7 (with 7a-7d substeps) are clearly sequenced, and validation is explicit throughout: two halt codes as entry gates, the 'no cell above level 1 on self-assessment alone' rule as a data-quality gate, and feedback loops for error recovery - 'fix the matrix first and name the offending cells' and marking stale matrices for re-assessment rather than silently proceeding. The anti-patterns table functions as a checklist. This matches the level-5 anchor and is above level 4, whose validation coverage has minor gaps.

5 / 5

Progressive Disclosure

The body is the working procedure and the bulky worked example is correctly offloaded to a single clearly-signaled reference - 'See [references/skill-matrix-example.md](references/skill-matrix-example.md) for the full 5-person matrix' - placed at exactly the right point (Step 4). The referenced file exists in the bundle, is one level deep, and is the only reference; no structure is inlined that belongs elsewhere. Matches the level-5 anchor.

5 / 5

Total

19

/

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 dense, highly specific description that names every workflow stage and its taxonomy, gives an explicit 'Use when' clause with concrete manager scenarios, and proactively excludes neighboring skills. The only gap is synonym coverage for the core terms (e.g., 'competency matrix', 'capability assessment'), which leaves trigger-term coverage just short of comprehensive.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: "produces a QA team skill matrix", "classify each gap (coverage / capability / bus-factor / surplus)", "rank the gaps against the team's roadmap", "recommend a closing move per gap (train / peer-learn vs hire vs external expert)". It matches the anchor 'lists multiple specific concrete actions; comprehensive coverage' and exceeds the level-4 anchor, which expects minor gaps in coverage; every stage of the workflow is named with its taxonomy.

5 / 5

Completeness

It explicitly answers both questions: the 'what' is the full matrix-plus-gap-analysis pipeline with named sub-actions, and the 'when' is a literal trigger clause - "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 requisition" - with three concrete trigger scenarios. It also adds negative triggers ("not a point-in-time score of external candidates"), which level 4 ('when could be more explicit or specific') does not reach.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "QA team", "skill matrix", "gap analysis", "quarterly planning", "training-budget decision", "opening a requisition" - phrases a QA manager would plausibly say. Falls short of level 5 because common synonyms are missing ("competency matrix", "capability assessment", "skills gap", "upskilling"), so it is not comprehensive synonym coverage; it is clearly above level 3, which expects missing common variations.

4 / 5

Distinctiveness Conflict Risk

Clear niche (ongoing team capability mapping) with distinct triggers, and it explicitly fences off the adjacent skills - "not a point-in-time score of external candidates and not one new hire's ramp plan" - minimizing conflict with hiring-kit or onboarding skills. Not level 4 because no minor overlap risk remains unaddressed; the exclusions are explicit.

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

Table of Contents