big-idea
Skill0 starsChanged 9 days agoMITView on GitHub
Distill the central claim before authoring any summary-shaped output: hero copy, commit-message subject, PR title, ADR title, slide title, executive summary, skill description, abstract. Length is format-dependent (1 sentence for titles, up to a short paragraph for complex theses), tested against the Saint-Exupéry rule (remove sentences until removing another would break the claim). Chart summaries use the bundled chart-big-idea skill.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- thatjuan/agent-skillstheir own version, first seen Oct 20, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- thatjuan/agent-skills★ 1same 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 repository66 other files it gives its agents.
- AGENTS.mdAGENTS.md
- skills/bootstrap-project/resources/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- skills/bootstrap-project/resources/CLAUDE.mdCLAUDE.md
- act-tenetsSkill
- adversarial-reviewSkill
- annotate-screenshotSkill
- anti-hallucinationSkill
- ascii-chartSkill
- assess-brainSkill
- bootstrap-coreSkill
- bootstrap-projectSkill
- browser-toolsSkill
- chart-big-ideaSkill
- chart-interpretationSkill
- chart-vocabularySkill
- code-reviewSkill
- communication-craftSkill
- compile-brainSkill
- convertSkill
- corpus-qa-sweepSkill
- critical-thinkingSkill
- deep-reviewSkill
- doc-hygieneSkill
- docs-shellSkill
- docx-to-mdSkill
- ethical-reasoningSkill
- evaluate-before-adoptingSkill
- figure-generatorSkill
- flint-chartSkill
- flint-interactionsSkill
- flint-themeSkill
- git-workflowSkill
- html-to-mdSkill
- humanizerSkill
- install-visual-companionsSkill
- lint-clean-markdownSkill
- markdown-mermaidSkill
- markdown-sanitization-chainSkill
- md-to-emlSkill
- md-to-htmlSkill
- md-to-txtSkill
- md-to-wordSkill
- meditationSkill
- mutation-testingSkill
- planSkill
- platform-awarenessSkill
- print-svg-style-guideSkill
- proactive-awarenessSkill
- problem-framing-auditSkill
- project-capability-authoringSkill
- project-statusSkill
- render-chartSkill
- render-verifySkill
- rich-emailSkill
- risk-analysisSkill
- security-and-hardeningSkill
- setup-dependenciesSkill
- setup-enterprise-stackSkill
- spikeSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
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 50
Test: if someone read only this sentence and nothing else, what would they know that they didn't before?
- Distinctive: line 71
Test: read the draft and ask _"so what?"_ If nothing changes for the reader, revise.
- Distinctive: line 106
No TOC enumeration: no bulleted-list-as-sentence.
- Distinctive: line 108
No compression theater: if a semicolon or colon is doing the work of a full stop and the second clause could stand as its own sentence, …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Big Idea
"Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away." — Antoine de Saint-Exupéry, Terre des hommes (1939)
Distill the central claim before authoring any summary-shaped output. Every hero subtitle, commit subject, PR title, ADR title, slide title, executive summary, and skill description should carry a Big Idea: a testable thesis that answers "what changes for the reader?", not an enumeration of what's inside the artifact.
Generalized from chart-big-idea, which specializes this discipline for chart authoring. This skill covers everything else.
When to Fire
| Context | Big Idea IS... |
| Hero copy (doc subtitle) | The doc's thesis |
| Commit-message subject | The change that matters, not the file diff |
| PR title | The reviewer's decision-changer |
| ADR title | The boundary the decision draws |
| Slide title | The claim the slide argues |
| Executive summary abstract | The one thing the reader needs from the memo |
Skill description (frontmatter description field) | The "what + when" that makes discovery work |
| Meeting agenda item | The decision the discussion should produce |
| Blog post headline | The claim the post argues (not the topic it covers) |
When NOT to Fire
- Plain body prose — Big Idea authoring is for headlines, not paragraphs. Body prose defends the Big Idea; it isn't one.
- Bullet lists inside a doc — each bullet doesn't need its own thesis. The section header carries the Big Idea if any bullet does.
- Code comments — unless the comment IS a thesis (rare — most code comments explain how, not why anything changes).
- README intro paragraphs — those get to be longer than one sentence. Use Big Idea for the README's title tagline, not its opening paragraph.
- Chart workflow — when called by chart-big-idea, complete the shared distillation here and return the claim, audience, and stance. Do not load chart-big-idea again: the caller owns the Chart Brief and chart-specific constraints.
The four-step distill (plus emit)
Skipping any step is why summaries drift back to tactical enumeration. Run all four before writing the sentence.
1. Read for an existing Big Idea
Scan the source artifact (doc body / commit diff / ADR argument / slide content) for the central claim already stated. Often the Big Idea is buried in a middle paragraph or half-said in a conclusion. If it's there, extract; if not, distill from scratch.
2. Distill the claim
What is THE one thing this artifact argues? Not "what topics does it cover" — what claim does it make?
Test: if someone read only this sentence and nothing else, what would they know that they didn't before?
3. Story arc
Name the narrative shape — it informs the sentence's grammar and tense:
| Arc | Signal | Big Idea shape |
| Chronological | "we did X, then Y, then Z" | "Migration X taught us Y" — past tense, cause + lesson |
| Comparative | "A vs B; here's why we picked A" | "A costs less than B because C" — contrastive |
| Prescriptive | "here's what to do next" | "Do X before Y or you'll hit Z" — imperative |
| Cautionary | "here's what to avoid" | "Skipping X guarantees Y" — warning |
| Diagnostic | "here's what broke and why" | "Bug X was caused by Y; fix is Z" — analysis |
4. Audience + stakes
Who reads this artifact, and what changes for them?
- A Big Idea that names the reader's decision (implicitly or explicitly) is thesis-shaped.
- A Big Idea that names only the topic is TOC-shaped.
Test: read the draft and ask "so what?" If nothing changes for the reader, revise.
5. Stance
Is this Big Idea:
- Consolidating consensus — confirming what the reader already believes. Safer, less punchy, room for qualifiers.
- Challenging a norm — contesting a default assumption. Higher risk, higher payoff, strip qualifiers.
Analogous to TRADITIONAL vs. INNOVATIVE in chart-big-idea. The stance sets qualifier budget: consolidating leaves in "often"/"usually"; challenging strips them out.
6. Emit and compress
The Saint-Exupéry rule is the actual gate. Draft the Big Idea, then apply the removal test: try deleting each sentence. If deleting it leaves the claim intact, delete it. Repeat until removing another sentence would break the claim. What remains is the Big Idea.
Length ceiling depends on format:
| Format | Natural ceiling | Why |
| Chart caption | 1 sentence | The chart carries the payload |
| Commit subject / PR title | 1 sentence | Format-imposed by git / email |
| ADR title | 1 sentence | Index-scanning convention |
| Slide title | 1 sentence | Reader is glancing |
| Hero copy / doc subtitle | 1–3 sentences | Reader is scanning; three beats before commitment |
| Executive summary / abstract | 2–4 sentences | Reader has committed; density is the point |
| Complex-thesis Big Idea | Short paragraph | Some claims genuinely need setup + insight + qualifier |
Count the draft's sentences with the script, not by eye: node scripts/count-sentences.cjs <draft-file> --ceiling <N>, where N is the format's ceiling from the table above. The gate reads the script's count.
Discipline for every sentence that survives the removal test:
- Answers "what changes for the reader?"
- Names a specific claim, not a topic so the claim is testable.
- Someone could reasonably argue against it; if not, it's a truism, not a thesis.
- Concrete over abstract: carry a name, number, or contrast where possible.
- No TOC enumeration: no bulleted-list-as-sentence.
- No hedge stacking: pick one hedge or none.
- No compression theater: if a semicolon or colon is doing the work of a full stop and the second clause could stand as its own sentence, split it. Compression is real only when the removal test would break the claim.
- American English by default (if your project defines a language rule in
copilot-instructions.md, follow it — Alex ACT itself uses American English). Usecolor,behavior,center,catalog,license,analyze,favor,honor,defense. Avoidcolour,behaviour,centre,catalogue,licence,analyse,favour,honour,defence. Three carveouts stay: the[behaviour]commit-tag API string, ACT framework canonical terms, and ported material that retains its source spelling. - No AI-tells. Alex ACT bans em-dashes as sentence separators in shipped prose; the full 29-pattern catalog is in humanizer. No em-dashes as sentence separators (use commas, colons, semicolons, parentheses, or full stops instead); no filler intensifiers (
comprehensive,robust,leverage,seamlessly,delve into,tapestry,weave,testament); noload-bearingas a synonym forimportant / central / key(see humanizer Pattern 7 for the technical-vs-decorative carveout); no performative openers (Certainly!,Great question!,Let me...); no meta-description (This document explains...,The following is...); no ceremonial rule-of-three parallelism used as decoration rather than argument. The fixed-string part of this check (banned intensifiers, performative openers, meta-description, em dashes) is mechanical: runnode scripts/lint-ai-tells.cjs <draft-file>and read its hits instead of scanning by eye. The judgment tells (rule-of-three, compression theater) stay with the reader.
Anti-patterns
| Anti-pattern | Symptom | Rewrite discipline |
| TOC enumeration | Lists chapters instead of naming the claim | Ask: "what does the doc argue?" — write that. |
| Position statement | Names what the doc IS without saying what it CLAIMS | Add the "so what?" — what changes because of this thing? |
| Poetic count-up | Rhythmic but content-free ("one brain, five regions, five loops...") | The rhythm is style, not substance. What's the argument? |
| Feature enumeration | "A · B · C · D" separated by middots | Middots hide missing thesis. Pick one claim; defend with the features in body. |
| Overpromise | Claim exceeds what the artifact delivers | Read the body and cut back to what it actually earns. |
| Hedge stacking | "May", "could", "often", "usually" all in one sentence | Pick one hedge or none. Multiple hedges signal you don't believe your own claim. |
| Passive voice on the verb | "Improvements were made to X" | Big Ideas have subjects. "X now Y because Z." |
| Meta-description | "This doc explains..." | Skip the "this doc explains" and just make the claim. |
| British spelling | "colour", "behaviour", "centre", "catalogue", "licence" | American English by default. Three carveouts stay: [behaviour] API tag, ACT framework canon, ported material. |
| AI-tell vocabulary | "comprehensive", "robust", "leverage", "seamlessly", "delve into", "tapestry", "weave", "testament" | Strip. See humanizer for the 29-pattern catalog and voice replacements. |
| Em-dash as sentence-separator | Em-dash standing in for a colon, semicolon, or full stop | Banned in shipped Alex ACT prose. Use a colon (for "here's why"), a semicolon (for a paired thought), parentheses (for a side note), or split the sentence. |
| Performative preamble | "Certainly!", "Great question!", "Let me..." before the claim | Skip the throat-clearing. The Big Idea is the first word. |
| Compression theater | Semicolon or colon doing the work of a full stop; second clause is either a re-worded first clause or would earn its own sentence | Apply the removal test. If the second clause is a full stop in disguise, split it. If both clauses say the same thing, delete the redundant one. |
Worked examples
From the 2026-07-28 hero-copy sweep on this repo. Note the shape: before is enumeration of contents; after is a compressed thesis (one or two sentences, per the removal test) with a subject verb and a because or so.
| Doc | Before (tactical) | After (Big Idea) |
plan/plan | "From heir-template to plugin-native — every folder, cloud store & identity that touches this box" | "The v1 template lineage costs too much to maintain per heir. Migrating to Copilot CLI plugins moves complexity from twenty-five heirs back to one source." |
docs/act | "Manifesto · 10 tenets · claims registry · failure modes · engineering binding · curation rules" | "AI is trained to agree with you. ACT is the discipline that makes it push back on the claims that matter." |
operations/fleet | "Heir markers · hybrid local+GitHub inventory · dashboard · reports" | "Fleet is visibility, not control. Steward never mutates a heir, so the dashboard reports what heirs decide, not what Steward wants." |
plan/fundamentals | "One brain, five regions, five loops, seven primitives, ten tenets, one dial, one fleet" | "Every capable AI partner runs the same seven cognitive primitives. Naming them turns AI craft into engineering." |
Cross-domain examples (not from a real commit — showing the shape)
Commit-message subject (arc: diagnostic; stance: challenging):
- Before:
refactor: update fetch logic to handle timeouts - After:
[behaviour] fetch: 3s timeout replaces indefinite hang on unreachable release
PR title (arc: prescriptive; stance: consolidating):
- Before:
Update dependencies - After:
Bump marked to 12.0.0 to unlock the token-object renderer API needed by mermaid-in-code-fence support
ADR title (arc: comparative; stance: challenging):
- Before:
ADR-014: Mall v1 to v2 migration approach - After:
ADR-014: Mall in-place bump to 3.0.0 (not fork-and-freeze) because 5 of 25 heirs currently route through the affected surface
Related
chart-big-idea— chart specialization. Both skills share the same six-step arc with offset numbering: chart-big-idea Step 0 (read context) → this skill's Step 1; chart-big-idea Steps 1-4 → this skill's Steps 2-5; chart-big-idea Step 5 emits a Chart Brief while this skill's Step 6 emits prose.- Skill descriptions ARE Big Ideas — the frontmatter
descriptionfield's "what + when" is the thesis + trigger of the skill's Big Idea. - communication-craft — sibling skill for feedback, audience, and elicitation. Communication craft frames the whole message; Big Idea frames only the headline.
- humanizer — the 29-pattern AI-tell catalog and voice replacements. Big Idea authoring routes through humanizer for the AI-tell check before emit.
- problem-framing-audit — different discipline: audit the frame BEFORE solving. Big Idea distills the claim AFTER solving. Both cite the same "is this the right thing?" test but at different phases.
Falsifiability
This skill has failed if any of the following occur:
- Decorative steps: the four-step distill (context read → claim → arc → stance → emit) consistently produces identical output to skipping steps 3–5 — the extra steps are ritual, not method
- Drifts from parent:
chart-big-ideaupstream evolves in a way this skill can't accommodate — the specialization relationship broke
Would Revise If
- A domain surfaces where step 3 (story arc) doesn't map cleanly to the five listed arcs → extend the table with the missing arc, or reduce to arcs-are-optional guidance
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.

