skills/strategist-voice/SKILL.md
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.
npx skillsauth add lyndonkl/claude strategist-voiceInstall 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.
Apply this skill in the final consolidation step of a strategist or analyst report, when freeform working notes are being shaped into a publishable long-form document. The output should read like a research note from a buy-side desk or a strategy consultancy, not like a default assistant response.
The house style synthesizes two analyst-blogger voices:
Both write at a sentence level that no LLM default produces. The rules below capture what they share. Where their habits do not serve a strategist report (notably their heavy use of em dashes), this skill deliberately diverges.
The consolidating agent must enforce these. They are non-negotiable. Run the checklist at the end of this file before treating the report as done.
Strategist inference: prefixes. Signal synthesis through phrasing (see "Opinion signaling" below).claim text.[^7] in the body with [^7]: Source — URL in a bibliography section. Never inline [Source: Org — URL] or (Source: Org, URL).Replace Strategist inference: with specific phrasing. The strength scale runs from tentative to high-conviction:
Use first-person ("we," "this analyst's reading," "in our reading") sparingly. Once or twice per long section is correct; once per paragraph is wrong. Reserve it for the genuine judgment calls.
Use one of these three patterns. None of them define the company.
Banned openings: "Company X is a Y that does Z," definitions of the product category, restatements of the directive.
Numbered footnotes. In the body:
Figma's Q4 2025 revenue grew 40% year on year.[^7]
In the bibliography section at the end of the report, grouped by source type:
**Primary company material**
[^1]: Figma — How Figma's multiplayer technology works — https://www.figma.com/blog/...
[^7]: Figma Investor Relations — Q4 2025 results — https://investor.figma.com/...
**Founder and executive voices**
[^12]: Lenny's Podcast with Dylan Field, October 2025 — https://...
**Engineering and architecture material**
[^18]: ...
**Secondary analysis**
[^24]: ...
Footnote markers go after the sentence punctuation. Never two markers on the same fact. Never a parenthetical citation inside a sentence.
See style-examples.md for annotated good-and-bad rewrites of opening paragraphs, opinion-signaled sentences, negation-cascade fixes, citation forms, and synthesis statements.
Copy this into the working response when consolidating the final report. Tick each item before declaring the report finished.
Strategist-voice final pass:
- [ ] Zero em dashes in the final document
- [ ] Zero "not X, not Y, not Z" negation cascades
- [ ] Zero `Strategist inference:` prefixes (or any variation thereof)
- [ ] Zero inline `[Source: ...]` or `(Source: ...)` citations
- [ ] Zero "It's worth noting" hollow openings
- [ ] Zero "In conclusion / Ultimately / To summarize" closers
- [ ] The opening paragraph uses one of the three permitted patterns
- [ ] At least three opinion-signaling phrases (from the list above) appear in the synthesis section
- [ ] Sentence length varies visibly within paragraphs
- [ ] First-person ("we," "this analyst's reading") used at most twice per major section
- [ ] Bibliography is grouped by source type and uses numbered footnote anchors that match in-text markers
- [ ] Every strategy-jargon term ("wedge", "flywheel", "TAM", "NDR", "moat", "attach rate", "X-shaped" labels, etc.) is either defined on first use or rewritten away
- [ ] No abstract X-shaped / Y-shaped label is doing the analytical work that a concrete description should be doing
If any box cannot be ticked, return to the draft and fix before producing the final markdown.
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
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.
development
Domain-neutral methodology for evaluating completeness and logical soundness of an extracted set of components, then transforming them into actionable guidance. Runs the "is it true / is it complete / what of it" critical evaluation pass before any final artifact is built. Checks for completeness gaps, logical consistency, contradictions, and practical applicability. Reusable across any extraction workflow - skill creation (evaluating extracted components before building SKILL.md), paper extraction (evaluating Pass 2 extraction notes before deep reading), report writing (evaluating gathered evidence before synthesis). Use when an agent has extracted structured components from a source and needs to gate-check before downstream commitment. Trigger keywords - synthesis evaluation, completeness check, logic check, critical evaluation, fact-check before synthesis, gap analysis, what is not said.