CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/exec-quality-narrative

Build-an-X workflow that turns already-computed quality data - weekly digests, KPI roll-ups, DORA delivery metrics, escape-defect trends, OKR grading - into an executive or QBR narrative structured by the Minto Pyramid Principle: governing answer first, MECE-grouped support beneath it, SCQA opening (Barbara Minto, The Pyramid Principle, ISBN 978-0273710516). Distinct from single-team digest computation (which computes the RAG digest from raw CI and tracker signals; this skill consumes such digests and writes the upward story), from portfolio-review aggregation (which aggregates teams into a portfolio review; this skill is the communication layer either output feeds), and from QA OKR authoring (forward-looking commitments; this skill narrates what happened and what it means). Use before a QBR, board update, or exec review when the data exists but the story does not.

74

Quality

93%

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

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-sequenced, actionable instruction skill with explicit validation checkpoints and clean one-level-deep reference files. Its only weakness is conciseness: the Overview restates concepts Claude already knows (MECE, SCQA, a Minto quote) and carries date stamps and an inline ISBN that add tokens without aiding the task.

Suggestions

Trim the Overview's gloss of MECE ('mutually exclusive, collectively exhaustive') and the SCQA definition to a single cited phrase; Claude already knows these concepts, so keep only the framework name and the book citation.

Remove the in-body 'fetched 2026-06-10' date stamps and the inline ISBN (978-0273710516) from the Overview and Steps; the References section already records these and they add tokens that do not aid the narrative task.

Condense the Barbara Minto Wikipedia quote in the Overview to a short attributed phrase, since the full citation already appears in the References section and the quoted sentence mostly restates the pyramid concept.

DimensionReasoningScore

Conciseness

The Overview explains concepts Claude already knows (MECE glossed as 'mutually exclusive, collectively exhaustive', SCQA defined, a Minto Wikipedia quote) and carries in-body 'fetched 2026-06-10' stamps plus an inline ISBN; it is mostly efficient but could be tightened. Not a 3 because these tokens restate known concepts rather than earn their place; not a 1 because the steps and tables are otherwise dense and actionable.

2 / 3

Actionability

Steps 1-5 give concrete executable guidance for an instruction-only skill: an input table with sources and roles, two precision rules, SCQA slots with literal example sentences, a named MECE grouping pattern, and a minimal markdown output template in a code block. Not a 2 because it provides specific, copy-paste-ready structure rather than vague direction.

3 / 3

Workflow Clarity

Steps 1-5 are clearly sequenced with an explicit validation checkpoint ('Halt with UNCITED_INPUTS') and a feedback loop ('If it cannot be written ... go back to the inputs, not to the slide deck'). Not a 2 because checkpoints are explicit rather than implicit; this is not a destructive/batch operation so the cap-at-2 rule does not apply.

3 / 3

Progressive Disclosure

SKILL.md is an overview that signals two real, one-level-deep reference files ('references/dora-metrics.md' for DORA definitions, 'references/qbr-narrative-example.md' for the worked example), both verified to exist, with detail appropriately split out rather than inlined. Not a 2 because references are clearly signaled and shallow; not a 1 because there is no nested or monolithic structure.

3 / 3

Total

11

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, trigger-rich, and complete, with an explicit 'Use when' clause and clear distinctiveness from sibling skills; voice is correctly third-person. It is a strong, well-scoped description that would surface for the right request.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'turns ... quality data ... into an executive or QBR narrative structured by the Minto Pyramid Principle: governing answer first, MECE-grouped support beneath it, SCQA opening', naming concrete structural methods rather than vague verbs.

3 / 3

Completeness

Explicitly answers both what (turns quality data into a Minto-structured narrative) and when ('Use before a QBR, board update, or exec review when the data exists but the story does not'), with an explicit 'Use ... when' trigger clause, and keeps third-person voice throughout.

3 / 3

Trigger Term Quality

Includes natural terms users say ('QBR', 'board update', 'exec review', 'DORA delivery metrics', 'OKR grading', 'escape-defect trends', 'weekly digests'), giving good coverage of natural trigger vocabulary rather than technical jargon.

3 / 3

Distinctiveness Conflict Risk

Explicitly distinguishes the skill from three siblings ('Distinct from single-team digest computation ... from portfolio-review aggregation ... and from QA OKR authoring'), carving a clear niche with distinct triggers unlikely to fire for the wrong skill.

3 / 3

Total

12

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents