Skills/writing/linkedin-post/SKILL.md
Crafts high-performing LinkedIn posts from any topic, story, announcement, or idea. Use this skill when a user needs to write, draft, improve, or optimize a LinkedIn post — including personal stories, product announcements, thought leadership, professional milestones, or content repurposing. Triggers include requests to "write a LinkedIn post about", "help me announce this on LinkedIn", "make this sound better for LinkedIn", or when a user provides a transcript, article, achievement, or idea they want to share professionally.
npx skillsauth add zrosenfield/sharepoint-ai-skills linkedin-post-writingInstall 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.
This skill transforms any topic, story, or announcement into a compelling LinkedIn post that earns engagement. The goal is always a post that stops the scroll, delivers real value, and invites a response.
LinkedIn truncates posts after roughly 140 characters — everything after that is hidden behind a "see more" link. This makes the opening line the single most important element. Readers decide in under two seconds whether to keep reading.
Beyond the hook, high-performing posts share three traits: they are easy to scan, they offer a clear point of view, and they end with a reason to respond.
Every strong LinkedIn post follows this arc:
1. Hook — The opening line that earns the click. Make it specific, surprising, or immediately relevant. Never bury the lead with context-setting. The best hooks make a bold claim, ask a provocative question, or open a story mid-action.
2. Context — One or two sentences that explain why this matters. Set up the problem, tension, or opportunity. Keep it brief — readers want the payoff, not the backstory.
3. Core value — The insight, lesson, announcement, or story. This is the substance. Use short paragraphs (one to two sentences each) with a blank line between them. Bullet points work well for lists of three or more items.
4. Implication — Why should the reader care? Zoom out to the broader lesson, trend, or takeaway. This is what makes the post shareable beyond your immediate network.
5. Call to action — Close with a question, invitation, or next step. Posts that end with a direct question get 20–40% higher engagement. Options include: asking for the reader's experience, directing them to a link, or prompting them to share the post with someone who needs it.
Choose the hook type that fits the content:
The result first — Lead with the outcome, then explain how you got there. ("We tripled response rates. Here's what changed.")
The counterintuitive claim — State something that challenges a common assumption. ("Most onboarding checklists make new hires worse at their job.")
The specific story — Drop the reader into a scene. Use a number, a name, or a concrete detail. ("Last Tuesday, a five-minute conversation saved us three months of rework.")
The direct question — Ask something your audience is already wondering. ("Why do so many good ideas die in the first meeting?")
The bold announcement — State the news clearly and immediately. ("We just launched [X]. Here's what it does and why it matters.")
Length — 150 to 300 words is the sweet spot for most posts. Text-only posts in the 1,300–1,800 character range tend to see peak reach. Going under 1,000 characters can lose up to 25% of potential engagement.
Paragraphs — Maximum two sentences per paragraph. Always add a blank line between paragraphs. Dense text blocks lose readers immediately.
Bullets — Use them for lists of three or more. Do not use bullets for single items or as a substitute for proper sentences.
Emojis — Use sparingly (one to three per post maximum) and only where they add meaning or visual separation. Never use them as decoration.
Hashtags — Three to five relevant hashtags at the end of the post. Do not embed hashtags in the body text.
Links — LinkedIn's algorithm deprioritizes posts with external links in the body. Either place the link in the first comment and reference it in the post ("link in comments"), or include it at the end after all substantive content.
Personal story — Best for building trust and relatability. Leads with a specific moment, challenge, or realization. The most shareable format when the story has a transferable lesson.
Announcement — Best for launches, milestones, or news. State the news in the first sentence, then explain what it means and why it matters. End with a clear next step.
Thought leadership — Best for establishing expertise. Takes a clear position on a topic, backs it up with evidence or experience, and invites disagreement. Avoid hedging — a strong opinion performs better than a balanced both-sides take.
How-to or list — Best for educational content. Use a numbered list or bullets. Front-load the most valuable item, not the most obvious one.
Repurposed content — Best for extending the reach of existing work (an article, talk, or project). Extract the single most interesting insight and build the post around that, rather than summarizing the whole piece.
Before writing, identify:
If the user has not provided a clear angle or audience, ask before writing. A post written for the wrong audience or with the wrong angle will need to be scrapped, not revised.
Before finalizing any post, verify:
For every post, deliver:
testing
--- name: review-council description: Convene a council of expert AI personas to review, stress-test, and improve any document, idea, proposal, or plan. Use this skill whenever the user asks to "review," "stress-test," "get feedback on," "critique," "poke holes in," "red team," "evaluate," "council," "panel review," or "get perspectives on" any content — whether it's an uploaded Word doc, Excel spreadsheet, PowerPoint deck, PDF, or just a raw idea typed into chat. Also trigger on phrases like "w
tools
Generates a polished, self-contained HTML heatmap scorecard — a weighted comparison matrix where entities (rows) are scored across dimensions (columns), with computed totals, rank badges, and a winner highlight. Use when asked to build a scorecard, comparison matrix, decision matrix, vendor evaluation, tool assessment, candidate scoring grid, competitive analysis, site-readiness matrix, or any weighted multi-criteria ranking. Interviews the user if entities or criteria are missing, constructs a validated JSON document, then renders it into a sandbox-safe HTML file using the component library. No external dependencies — output runs inside a SharePoint sandboxed iframe.
development
Generates a polished, self-contained HTML roadmap or milestone timeline from any project data — SharePoint lists, pasted tables, or a verbal description. Use when asked to build a project roadmap, product roadmap, migration timeline, release plan, onboarding sequence, run-of-show, phase plan, or any visual schedule showing items over time. Interviews the user if data is incomplete, constructs a validated JSON document, then renders it into a single sandbox-safe HTML file. Chooses between two layouts automatically: horizontal roadmap with swimlanes (for phase-range data) or vertical milestone list (for point-in-time events). No external dependencies — output runs inside a SharePoint sandboxed iframe.
development
Generates a polished, self-contained HTML executive report or dashboard from any data source — SharePoint lists, CSV exports, or a user description. Use when asked to build an exec report, one-pager, summary page, status dashboard, project summary, business review, or any single-page visual summary of data. Interviews the user if data is incomplete, constructs a validated JSON document block by block, then renders it into a single sandbox-safe HTML file using the component library. No external dependencies — output runs inside a SharePoint sandboxed iframe.