skills/opener-critique/SKILL.md
--- name: opener-critique description: Evaluates the first 1-3 sentences of a substacker draft against the writer's signature opener patterns — confession / "I hadn't done X" / reframe / small concrete admission. Classifies opener as confession | reframe | admission | news-hook | generic-opener and flags news-hook/generic as tier-1. The opener sets the voice contract for the essay. Use on every draft. Trigger keywords: opener, hook, first sentence, opening, confession opener, news hook, generic
npx skillsauth add lyndonkl/claude skills/opener-critiqueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Related skills: Called by Editor in structural pass. Sets tone contract; downstream skills (voice-check, slop-detector S1) can reference its classification.
| Class | Markers | Voice verdict |
|---|---|---|
| confession | I hadn't, I used to think, I did not know, Until last week, I spent three hours, I was wrong about | PASS |
| reframe | X is commonly called Y — actually Z, Most people think X; actually Y | PASS |
| admission | I substitute learning for doing, I have been meaning to, I have opinions about X — the kind that feel like knowledge | PASS |
| puzzle (biology cold open) | Biological/systems question opened with a specific number or contradiction | PASS |
| epistolary | Dear friend, Dear reader, second-person address to a specific imagined reader | PASS (rare but valid) |
| news-hook | GPT-5 launched, Last week OpenAI, With the release of X, reacting to an external event | FLAG tier-1 |
| generic-opener | AI is transforming, In a world where, In today's fast-paced, As we enter a new era | FLAG tier-1 |
Evaluate opener:
- [ ] Step 1: Extract first 1-3 sentences
- [ ] Step 2: Match against classifier marker lists
- [ ] Step 3: Assign class
- [ ] Step 4: Write one-line justification
- [ ] Step 5: If news-hook or generic-opener, produce 2 rewrite options in the confession/admission register
Draft opener (bad): "In today's rapidly evolving AI landscape, teams face a critical choice between RAG and fine-tuning for domain knowledge."
Classification: generic-opener. Tier-1.
Rewrites:
Draft opener (good): "I spent a week re-prompting a customer-service agent before I realised the agent was the wrong unit of analysis."
Classification: confession (I spent, I realised). PASS.
Draft opener (puzzle — valid): "Your immune system can recognize roughly ten trillion distinct molecular threats. It does this with a genome that contains fewer than twenty thousand protein-coding genes. The math should not work."
Classification: puzzle. PASS.
testing
--- name: advisory-edit description: A strict advisory-only editing discipline for a writer who dictates ("speaks out") essays and wants help WITHOUT having their voice changed. The editor directs structure, flags grammar, and suggests strategic language — but never modifies the writer's text unless the writer explicitly says "apply" / "make that change" / "rewrite this." Produces a line-referenced, suggestion-only critique where every item is marked the writer's call. Four passes: structural, l
testing
Provides the house style for analyst-grade strategist writing — third-person register with sparing first-person, no em dashes, no "not X, not Y, not Z" negation cascades, numbered footnote citations rather than inline source parentheticals, specific opinion-signaling phrases, and topic-forward paragraph structure modeled on voice patterns observed in Damodaran's Musings on Markets and Thompson's Stratechery. Use when consolidating working notes into a finished long-form strategist or analyst report that must read as written by a senior human analyst rather than an AI assistant.
testing
Renders a markdown report to a PDF using pandoc with xelatex (11pt serif body, 1-inch margins, numbered footnotes, formal heading hierarchy). Requires a one-time install of pandoc and a LaTeX engine on the user's machine — basictex on macOS or texlive-xetex on Linux. Does not attempt automatic install. Fails loudly with the exact install commands if pandoc or xelatex is missing on the user's PATH. Use when producing a finished strategist or analyst report PDF from a polished markdown source.
testing
Produces step-by-step computational walkthroughs of vector and matrix operations as a sequence of numbered "frames", showing the explicit state at each step. The text-equivalent of a 3Blue1Brown animation — each frame shows what changed and why, so the learner can re-trace the operation by hand. Use when the learner needs to *see* a computation unfold (eigenvalue computation, attention with 3 tokens, gradient descent step, SVD on a 2×2, layer norm on a 3-vector, softmax of a small input), when an explanation has been given but the learner needs to ground it in a worked example, or when introducing an operation that's intimidating in symbol form but trivial in pencil-and-paper form.