CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/exec-quality-narrative

Use before a QBR, board update or exec review when quality data exists (digests, KPIs, DORA metrics, escaped defects, OKR grades) but the story does not. Writes the executive narrative with the answer first and grouped support beneath it, using the Minto Pyramid and SCQA.

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

85%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, highly actionable narrative skill with excellent workflow sequencing, validation checkpoints, and clean progressive disclosure into two real reference files. Its main cost is token overhead in the Overview and References, where known frameworks are re-explained and cited redundantly.

Suggestions

Compress the Overview: drop the verbatim Minto quotes, the MECE expansion, and the ISBN/fetched-date apparatus — one sentence naming the pyramid, MECE, and SCQA is enough for a competent reader, with the book citation kept only in References.

Trim the References section to remove duplication with the Overview (the Wikipedia quote appears in both) and cut meta-limitations like 'SCQA and the pyramid are cited to the book', which describe the skill's citation hygiene rather than its behavior.

Move time-stamped provenance details (fetched dates, the duplicate-path note in dora-metrics.md) out of the main reading path so the body carries only durable guidance.

DimensionReasoningScore

Conciseness

The Overview re-explains the Minto Pyramid, MECE, and SCQA with verbatim quotes and citation apparatus (ISBN, Wikipedia fetch dates), the References section repeats those citations, and Limitations includes meta items like "SCQA and the pyramid are cited to the book" — several instances of unnecessary explanation beyond 'minor'. The steps, tables, and anti-patterns sections themselves are tight and earn their tokens.

3 / 5

Actionability

Concrete throughout: an input table with named sources and narrative roles, a named halt condition (UNCITED_INPUTS), worked example sentences for each SCQA slot, named MECE group headers, an output skeleton in Step 5, and a fully worked QBR narrative in references/qbr-narrative-example.md. As an instruction-only skill the guidance is fully executable with common cases covered.

5 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced with explicit validation (halt on uncited inputs in Step 1) and a genuine feedback loop in Step 3 ("If it cannot be written, the analysis is not done; go back to the inputs, not to the slide deck"), reinforced by the anti-patterns table acting as a checklist. No destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

The body stays an overview and pushes detail to two real, one-level-deep bundle files, both clearly signaled: "the verbatim definitions are in references/dora-metrics.md" and "See references/qbr-narrative-example.md for the fully worked QBR narrative". Both files exist in the bundle and require no further nested reads.

5 / 5

Total

18

/

20

Passed

Description

95%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 in third-person voice that explicitly covers what the skill does and when to use it, with rich synonymous trigger terms and a well-defined niche. Its only gap is that the 'what' is expressed as one richly specified action rather than a list of several discrete capabilities.

DimensionReasoningScore

Specificity

"Writes the executive narrative with the answer first and grouped support beneath it, using the Minto Pyramid and SCQA" names the domain and several concrete action features. It stops short of the 5 anchor's list of multiple distinct actions, but clearly exceeds the 3 anchor's bare 1–2 generic actions.

4 / 5

Completeness

Both halves are explicit: what ("Writes the executive narrative with the answer first and grouped support beneath it") and when ("Use before a QBR, board update or exec review when quality data exists ... but the story does not"), with concrete trigger phrases throughout.

5 / 5

Trigger Term Quality

"QBR, board update or exec review" supplies three synonymous occasion triggers a user would naturally say, and "digests, KPIs, DORA metrics, escaped defects, OKR grades" covers the input vocabulary — comprehensive natural-term coverage including synonyms, matching the 5 anchor.

5 / 5

Distinctiveness Conflict Risk

The exec-quality-reporting niche with QBR/board-update triggers and quality-data inputs is clearly distinct from generic writing or reporting skills; the 4 anchor's 'minor overlap risk with closely related skills' does not fit better than the clear-niche 5 anchor.

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