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.

68

Quality

86%

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

77%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 skill body: a five-step workflow with real validation checkpoints and error-recovery loops, concrete worked examples, and a verified one-level-deep reference bundle. The main cost is token efficiency - the Minto framework is explained and quoted in three places, and citations (ISBN, Wikipedia quote, fetched dates) are duplicated between the frontmatter, Overview, and References sections.

Suggestions

Remove the duplicated Wikipedia quote - "can't derive an idea from a grouping unless the ideas in the grouping are logically the same" appears in both the Overview and Step 4; quote it once and cross-reference it from the other section.

Consolidate citations into the References section only: the ISBN 978-0273710516 appears in both the frontmatter description and the body, and the fetched dates (2026-06-10) are inline in References entries that already repeat URLs quoted earlier in the body.

Trim the Overview's explanation of the pyramid principle (top-down ordering, MECE as a concept Claude already knows) and keep only the operative vocabulary - the SCQA slot definitions and the answer-first discipline the steps actually use.

DimensionReasoningScore

Conciseness

The body restates the pyramid/MECE/SCQA framework in the Overview, again in Steps 3-4, and again in the Anti-patterns table; the Wikipedia quote ("can't derive an idea from a grouping unless the ideas in the grouping are logically the same") appears in both the Overview and Step 4, and the book citation with ISBN appears in the frontmatter and again in References. This is mostly efficient prose with some unnecessary repetition that could be tightened - the anchor-3 fit - rather than anchor-2 padding (the bulk is tight tables and numbered steps) or anchor-4 leanness (the duplicated quotes and citations across three sections are more than minor).

3 / 5

Actionability

For an instruction-only skill the guidance is concrete and executable: a Step 1 input table with sources and roles, a halt condition 'Halt with UNCITED_INPUTS if the supplied numbers carry no source artifacts', worked SCQA example sentences ('We ship weekly to 40k customers...', 'Q2 doubled deployment frequency while QA headcount was flat.'), a named grouping taxonomy ('outcomes ... delivery ... commitments ... capacity/risk'), and a fenced output template. It falls short of anchor 5 only in minor gaps: the Step 5 template is a compressed one-line skeleton ('## 1. Outcomes ... ## 2. Delivery ...') and the citation format is demonstrated only in the external reference, not in the body; it is well above anchor 3 because real example sentences, a halt code, and a template replace pseudocode.

4 / 5

Workflow Clarity

Five numbered steps in a clear sequence with explicit validation checkpoints and a feedback loop: Step 1 halts on 'UNCITED_INPUTS' when 'the supplied numbers carry no source artifacts'; Step 3 prescribes error recovery - 'If it cannot be written, the analysis is not done; go back to the inputs, not to the slide deck'; Step 4 gives an explicit grouping check ('headers that do not overlap and jointly cover the story'); and the Anti-patterns table maps each failure mode to its fix, functioning as a checklist. This matches the top anchor (clear sequence, explicit validation, feedback loops for error recovery); a 4 would require a missing checkpoint, and none is missing.

5 / 5

Progressive Disclosure

The bundle verifies: references/dora-metrics.md (27 lines) and references/qbr-narrative-example.md (38 lines) both exist, are referenced from the body with purpose signals ('the verbatim definitions are in [references/dora-metrics.md]', 'See [references/qbr-narrative-example.md] for the fully worked QBR narrative with real numbers and their sources'), and are one level deep - neither points onward to further skill files. The split is appropriate: verbatim DORA definitions and the worked example live in references while the workflow stays in the ~95-line body, matching the top anchor (clear overview, well-signaled one-level-deep references, easy navigation).

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: it names the transformation, enumerates its input types, states an explicit 'Use before...' trigger clause, and proactively differentiates the skill from its three nearest neighbors. The only weaknesses are minor - a few missing natural synonyms ('quarterly business review', 'executive summary') and a 'Build-an-X workflow' label that reads like a template placeholder.

DimensionReasoningScore

Specificity

Quotes several concrete actions - 'turns already-computed quality data - weekly digests, KPI roll-ups, DORA delivery metrics, escape-defect trends, OKR grading - into an executive or QBR narrative' with 'governing answer first, MECE-grouped support beneath it, SCQA opening' - which matches the anchor for several specific actions with minor gaps. It is not a 5 because the action list covers only the structuring transformation (internal behaviors like the UNCITED_INPUTS halt and DORA vocabulary rules are absent), and well above a 3 because the enumerated inputs and structural devices go beyond 1-2 concrete actions.

4 / 5

Completeness

Explicitly answers both questions: what - 'turns already-computed quality data ... into an executive or QBR narrative structured by the Minto Pyramid Principle' - and when - 'Use before a QBR, board update, or exec review when the data exists but the story does not.' The when-clause carries concrete trigger phrases and the voice is third person ('turns'), matching the top anchor exactly; a 4 would require the when to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural terms a user would say are well covered: 'QBR', 'board update', 'exec review', 'executive ... narrative', 'weekly digests', 'KPI roll-ups', 'DORA delivery metrics', 'escape-defect trends', 'OKR grading'. Not a 5 because common synonyms are missing - 'quarterly business review' is never spelled out, and phrases like 'executive summary', 'leadership update', or 'quality report' are absent; well above a 3 since coverage extends past a couple of generic keywords into the user's natural vocabulary.

4 / 5

Distinctiveness Conflict Risk

The description proactively fences off the three neighboring skills - 'Distinct from single-team digest computation ... from portfolio-review aggregation ... and from QA OKR authoring' - and carves a clear niche as the communication layer that 'consumes such digests and writes the upward story'. This is a clear niche with distinct triggers and minimal conflict risk, matching the top anchor; nothing in it would plausibly trigger the wrong skill.

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.

Reviewed

Table of Contents