lyndonkl/skills/structural-review
skills/structural-review/SKILL.md
--- name: structural-review description: Performs pass-1 structural review of a substacker essay draft — argument flow, out-of-order moves, buried topic sentences, missing pivots, weak signposting, paragraph-logic issues. Emits the "Argument flow" and "Structural blockers" sections of the Editor artifact. Use when reviewing a draft's macro-structure before addressing voice, when a draft feels like it meanders, or when the user asks whether the argument lands. Trigger keywords: structure, argumen
$ install --global
skillsauthnpx skillsauth add lyndonkl/claude skills/structural-reviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 10:22 AM138.7s1 file scanned
SKILL.md
- name:
- structural-review
- description:
- Performs pass-1 structural review of a substacker essay draft — argument flow, out-of-order moves, buried topic sentences, missing pivots, weak signposting, paragraph-logic issues. Emits the "Argument flow" and "Structural blockers" sections of the Editor artifact. Use when reviewing a draft's macro-structure before addressing voice, when a draft feels like it meanders, or when the user asks whether the argument lands. Trigger keywords: structure, argument flow, outline, signposting, meandering, pivot, macro edit, substantive edit.
Structural Review
Table of Contents
- Workflow
- Expected essay shape
- Worked example
- Guardrails
Related skills: Called by the Editor as the first structural skill. Runs before voice-check, hedge-detector, slop-detector. Pairs with paragraph-rhythm-check (paragraph logic) and opener-critique / closer-critique.
Workflow
Structural review of draft D:
- [ ] Step 1: Extract paragraphs as an array. For each: first-sentence topic + word count
- [ ] Step 2: Produce a 1-line-per-paragraph outline of the draft AS READ
- [ ] Step 3: Compare to expected essay shape (see below)
- [ ] Step 4: Flag out-of-order moves, buried topic sentences, walls, missing pivots, weak signposts
- [ ] Step 5: Per flag: tier (1 or 2), paragraph index, quote, reason, ≤2 suggested rewrites
Expected essay shape
Writer's signature shape (from voice-profile signature moves + opening/closing patterns):
1. Confession / concrete admission (opener)
2. Reframe / thesis
3. Exposition (mechanism, data, arithmetic)
4. Pivot (usually a one-sentence paragraph)
5. Applied case / example (often the IPL/Kalshi trade or a pathology slide)
6. Bolded maxim or forward-looking close
Not every essay hits every beat — short reflective posts skip steps 3 and 5. Series-log posts compress 2-3 and always include a scoreboard in 6.
Flag if:
- Hook is news-based or generic-opener (see
opener-critique). - Step 3 (mechanism) appears before step 1 (confession). "In this post we'll explore" structure = tier-1.
- Step 5 is missing in a full essay (not a series-log). Writer's voice has lived texture; its absence is a signal.
- Step 6 is absent entirely (no close). Tier-1.
- Buried topic sentence: the paragraph's point is in sentence 3 or later. Flag as tier-2.
- Wall: paragraph >120 words with no internal pivot. Flag as tier-2.
Worked example
Draft outline (as Editor reads it):
- Para 1 (42 w): "In today's AI landscape, teams often wonder whether RAG or fine-tuning…"
- Para 2 (81 w): Defines RAG.
- Para 3 (68 w): Defines fine-tuning.
- Para 4 (bullets): Comparison list.
- Para 5 (55 w): "I think RAG is the right choice for most teams."
- Para 6 (37 w): "To summarize, both have merit."
Flags (structural):
- (Tier-1) Hook is generic ("In today's AI landscape…"). Expected: confession. Rewrites: (a) "I spent four months moving a RAG pipeline to a fine-tune. I was wrong about which would win." (b) "I had never shipped a fine-tune until last quarter."
- (Tier-1) Mechanism before confession. Structural ordering violates the writer's shape. Rewrite: restructure so confession precedes exposition.
- (Tier-1) No pivot paragraph. Suggest: insert one-sentence paragraph at ~paragraph 3.5 marking the turn.
- (Tier-1) Argument runs through a bulleted list (para 4). Rewrite: convert to 3 short paragraphs, one mechanism each.
- (Tier-2) Closer is "To summarize" — prompt residue + no bolded maxim. Rewrite: replace with a mechanism close (e.g., "You're choosing where your domain knowledge lives — in weights, or in retrieval.").
Guardrails
- Never flag voice issues. This skill is structural only.
- Never propose more than 2 rewrite options per flag.
- Flags are located by paragraph index. If the writer paginates sections, cite section + paragraph.
- Do not rewrite the draft. Rewrites are ≤2 sentences each, bracketed.
- Series posts (frontmatter
series: {slug}) get a special-case: step 5 often IS the scoreboard+trade narration, not an extended applied case. Don't flag absence. - If the draft is a how-to / methodology post (H2 headers throughout, numbered steps), the expected shape is different (intro → sections → wrap). Detect and adapt.
Quick reference
- Input: draft markdown.
- Output: the "Structural pass → Argument flow" + "Structural blockers" sections.
- Runs first in the Editor pipeline.
Related Skills
lyndonkl/skills/advisory-edit
testing
VerifiedTrustedCommunity
--- 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
112SKILL.mdUpdated Jun 3, 2026
lyndonkl/strategist-voice
testing
VerifiedTrustedCommunity
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.
98SKILL.mdUpdated May 17, 2026
lyndonkl/markdown-to-pdf
testing
VerifiedTrustedCommunity
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.
98SKILL.mdUpdated May 17, 2026
lyndonkl/worked-example-walkthrough
testing
VerifiedTrustedCommunity
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.
94SKILL.mdUpdated May 10, 2026