exec-summary
Skill1 starsChanged 34 days agoMITView on GitHub
Write a 1-2 page decision-oriented executive summary — BLUF, Key Findings, Recommendation, Risks & Caveats — composable as the leadership-summary section of a fuller market-research or pentest report. Use when the deliverable is a short brief for decision-makers who will act without reading a full report. Anti-trigger; for the full study those decision-makers are summarizing use market-research-report or security-pentest (or prd for product requirements), not this genre.
7 other projects use a version of this.
Adopted by
Most recently taken up by
- itgenius-au/skills-librarytheir own version, first seen Nov 1, 2026
- Lwhieldon/claude-project-mgmt-playbooktheir own version, first seen Oct 13, 2026
- teachskillofskills-ai/DigitalMarketingPro-techshutheir own version, first seen Oct 11, 2026
- Jiplet/transformation-ostheir own version, first seen Jul 2, 2026
- janellecipriano/pm-skillstheir own version, first seen Jun 23, 2026
- hamzafarooq/claude-code-startertheir own version, first seen May 8, 2026
Other versions7 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 7
- indranilbanerjee/digital-marketing-pro★ 934same name
- hamzafarooq/claude-code-starter★ 145same name
- Lwhieldon/claude-project-mgmt-playbook★ 4same name
- Jiplet/transformation-os★ 2same name
- itgenius-au/skills-library★ 1same name
- janellecipriano/pm-skills★ 1same name
- teachskillofskills-ai/DigitalMarketingPro-techshu★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository46 other files it gives its agents.
- academicSkill
- adrSkill
- ai-architecture-docSkill
- arc42-arch-docSkill
- audit-docsSkill
- briefingSkill
- business-planSkill
- c4-model-diagramSkill
- changelogSkill
- clinical-submissionSkill
- competitive-quadrantSkill
- compliance-auditSkill
- computing-paperSkill
- diataxis-explanationSkill
- diataxis-how-toSkill
- diataxis-referenceSkill
- diataxis-tutorialSkill
- doc-set-plannerSkill
- ears-acceptance-criteriaSkill
- engineeringSkill
- feature-specSkill
- google-design-docSkill
- humanities-chicagoSkill
- humanities-mlaSkill
- kiro-designSkill
- kiro-requirementsSkill
- kiro-tasksSkill
- legal-memoSkill
- market-research-reportSkill
- mif-corpusSkill
- mif-frontmatterSkill
- mif-provenanceSkill
- mif-to-pdfSkill
- mif-validateSkill
- nist-spSkill
- playbookSkill
- prdSkill
- python-pepSkill
- regulatory-disclosureSkill
- rust-rfcSkill
- security-pentestSkill
- sre-runbookSkill
- sustainability-reportSkill
- svg-chartsSkill
- systematic-reviewSkill
- trend-analysisSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 5 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 43
Use active voice throughout — no "is drawn from", "was found to", "were identified".
- Distinctive: line 46
Never expose intermediate analysis, methodology narration, or an alternatives-considered discussion — that belongs in the fuller report …
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
exec-summary
Produces an executive summary: a short, standalone brief for decision-makers — executives, sponsors, board members — who need the conclusion and the single recommended action, and will not read past page two. Its center of gravity is the BLUF (Bottom Line Up Front) — the answer and the recommended action stated before any context. An exec summary states conclusions and their business consequence; it does not narrate method, explore alternatives, or expose intermediate analysis.
This genre follows the widely-used BLUF convention, with an additive optional overlay for composing into a fuller ESOMAR-style market-research report or PTES-style pentest report as their leadership-summary section.
Pattern (industry: BLUF executive summary)
- BLUF (Bottom Line Up Front) — one paragraph: the answer and the
recommended action, stated before any context. Never open with method or
background. The heading must literally contain "BLUF" (e.g.
## BLUF (Bottom Line Up Front)) so automated checks can locate it. - Key Findings — 3 to 5 bullets, each a single load-bearing fact with its "so what". Cite the source behind each quantified claim.
- Recommendation — one bold, specific, actionable directive. Include What / Why / How / Risk.
- Risks & Caveats — the 1 to 3 conditions under which the recommendation fails, plus the confidence basis for any uncertain finding.
Rules that keep it an executive summary
- Length is a hard ceiling: 1-2 pages (standalone mode). If it grows, cut — do not continue.
- The summary must stand alone: a reader who reads only this document can act correctly.
- Quantify at least one finding. Never fabricate a number; present a range when sources disagree and hedge ("estimated", "data suggests") for uncertain claims.
- Use active voice throughout — no "is drawn from", "was found to", "were identified". Write "Three controlled pilots show 40% efficiency gains," not "the 40% reduction is drawn from three controlled pilots."
- Never expose intermediate analysis, methodology narration, or an alternatives-considered discussion — that belongs in the fuller report this summary may introduce.
- Inline numeric citation markers (
[1],[2]) resolving to a compact footnote list. No bibliography, no appendices — footnotes only.
Composable mode (additive — off by default; render when requested)
Standalone is the default. When requested, render this genre as the leadership-summary section of a larger standard report — still emit the summary section shaped for embedding, not the whole multi-section report:
- Market-research report (
market-research-reportgenre) — render as the report's management summary that introduces the fuller study. Emit only that section, sized for embedding; do not generate the study's body sections. ESOMAR is an ethics code, not a report format — carry that caveat; do not claim ESOMAR-format conformance. - Pentest report (
security-pentestgenre) — render as the PTES Executive / Leadership Summary, expanded with its sub-elements: Posture (overall security posture), Risk Profile (business risk from the findings), and Roadmap (prioritized remediation direction). Emit only that section, not the full technical report.
Standalone behavior is unchanged when composable mode is not requested.
Anti-triggers — do not use this genre for
- The fuller study or report this summary would introduce — that is
market-research-reportorsecurity-pentest(orprdfor product requirements); this genre only produces the leadership-summary section. - A team-facing technical evaluation with a comparison table — that is
engineering. - A narrative alignment doc read by engineers before building — that is
google-design-doc.
MIF frontmatter
type: semantic — an executive summary is declarative decision-and-rationale
knowledge, not a time-bound event or a step sequence. Use
namespace: exec-summary/<area> and entity.entity_type: executive-summary.
Climb to L2 with namespace, modified, title, and tags when the
drafting context supplies them. Gate every output with mif-validate at its
target level; the floor is --level 1.
Why machine-readable — the point of MIF here
| Question an agent asks | Answered by (frontmatter) |
| Is this summary still current for the decision it supports? | temporal.validFrom / ttl |
| Where did the evidence come from; can I trust it? | provenance (W3C-PROV) + citations[] |
| What fuller report does this summarize? | typed relationships[] (relates-to) |
| Which claims are quantified vs. hedged? | citations[] tied to each Key Findings bullet |
The same document still reads as a human executive summary and projects losslessly to JSON-LD and back — one artifact, two readers.
The L1 -> L3 climb (two exemplars)
templates/good-l1.md— L1 floor:id,type,created+ body. A complete, valid summary, but opaque to a machine consumer.templates/good.md— L3 (highest this genre supports): addsnamespace,modified,temporalvalidity, W3C-PROVprovenance,citations[]tied to the Key Findings claims, and a typedrelationships[]graph (relates-tothe fuller report this summary introduces). Validate withmif-validate --level 3.
Author at the highest level the drafting context supports (grade down
rather than fabricate). templates/bad.md shows the antipattern: a summary
that buries the recommendation behind background and method instead of
leading with BLUF.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

