lyndonkl/skills/propose-section
skills/propose-section/SKILL.md
--- name: propose-section description: Converts one candidate cluster from cluster-corpus-by-theme into a named, promised section proposal ready for writer review. Calls write-section-promise for the one-sentence promise. Rates fit confidence (high / medium / low / provisional) and flags borderline posts. Use once per cluster that passes ≥3-post threshold. Trigger keywords: propose section, section proposal, new section candidate. --- # Propose Section ## Workflow ``` Per qualifying cluster:
$ install --global
skillsauthnpx skillsauth add lyndonkl/claude skills/propose-sectionInstall 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:19 AM138.1s1 file scanned
SKILL.md
- name:
- propose-section
- description:
- Converts one candidate cluster from cluster-corpus-by-theme into a named, promised section proposal ready for writer review. Calls write-section-promise for the one-sentence promise. Rates fit confidence (high / medium / low / provisional) and flags borderline posts. Use once per cluster that passes ≥3-post threshold. Trigger keywords: propose section, section proposal, new section candidate.
Propose Section
Workflow
Per qualifying cluster:
- [ ] Step 1: Name the cluster (working name from centroid codes)
- [ ] Step 2: Call write-section-promise for the one-sentence promise
- [ ] Step 3: Score each member post: tight | fair | borderline
- [ ] Step 4: Check non-overlap against existing section-map.md and other proposals this run
- [ ] Step 5: Assign fit_confidence:
- high: ≥5 tight-fit posts + strong cohesion + unambiguous non-overlap
- medium: 3-4 posts with mixed fit + narrowing promise
- low: borderline throughout; defer
- provisional: confident enough to name, uncertain enough to need probation
- [ ] Step 6: Write proposal block with reasons_to_reject (steelman the case against)
Output
proposal:
name: "{Human name}"
slug: {kebab-case}
promise: "{one sentence}"
fit_confidence: high | medium | low | provisional
supporting_posts: [{slug, fit}]
borderline_posts: [{slug, reason}]
non_overlap_check: "Distinct from {other section} because..."
reasons_to_reject: "Two of these posts also fit {other section}. If those migrate, cluster drops to 3 posts and becomes marginal."
Guardrails
- Never propose with <3 posts unless labeled PROVISIONAL + promise-testing plan.
- Never rename an existing section inside this skill — route through user-confirmation flow.
- Provisional sections require an explicit promotion test: "X more posts in Y weeks."
- Reasons-to-reject is mandatory — the Curator must pre-build a devil's advocate brief.
- Confidence is assigned from rules, not feel.
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