skills/linkedin-post-rewrite/SKILL.md
--- name: linkedin-post-rewrite description: Rewrites a published substacker essay as a LinkedIn post with a hook fitting the 210-char fold, practitioner framing (less confessional than Substack), short 2-3 line paragraphs, and 0-2 niche hashtags. 900-2500 characters. Emits linkedin-post.md. Use as the LinkedIn-native arm of the Distribution Translator. Trigger keywords: LinkedIn post, LinkedIn rewrite, practitioner, professional network, niche hashtags. --- # LinkedIn Post Rewrite ## Workflow
npx skillsauth add lyndonkl/claude skills/linkedin-post-rewriteInstall 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.
Rewrite for LinkedIn:
- [ ] Step 1: Load spine + chosen hook + voice-profile + audience-notes
- [ ] Step 2: Hook ≤210 chars (first 1-2 lines; must survive the "...see more" fold)
- [ ] Step 3: Line break, then one-sentence pivot paragraph
- [ ] Step 4: Body — 4-7 short paragraphs of 2-3 lines each (white space is structural)
- [ ] Step 5: Optional list block only if essay's spine is genuinely enumerable
- [ ] Step 6: Practitioner-takeaway closer (NOT bolded maxim — bold doesn't render well on LinkedIn)
- [ ] Step 7: Link line: `Full essay: {substack-url}`
- [ ] Step 8: 0-2 niche hashtags on final line (prefer 0-1)
- [ ] Step 9: Cap at 2500 chars total
LinkedIn reads "practitioner sharing learnings," not "writer thinking aloud." Slight voice shift allowed:
---
source_post: {slug}.md
platform: linkedin
target_length: 900-2500 chars
actual_length: {N}
length_mode: short | long
hook_chars: {N}
hashtags: 0-2
section: {section-slug}
---
{hook — first 1-2 lines, ≤210 chars total}
{one-sentence pivot paragraph}
{body — 4-7 short paragraphs, 2-3 lines each}
{optional list block only if genuinely enumerable}
{practitioner takeaway — not bolded}
Full essay: {substack-url}
{#NicheHashtag1 #NicheHashtag2} ← 0-2 only
#MultiAgentSystems, #LLMEngineering). Never generic (#AI, #tech, #innovation, #thoughts, #leadership).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.