LinkedIn Article Auditor skill for Claude and Codex
A 1 to 5 rated critique of a LinkedIn article covering headline, hook, structure, SEO gaps, tone, and shareability, ending in a fix checklist.
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when a published or drafted LinkedIn article needs a critique of its headline, hook, keyword use, tone, and engagement before it is promoted or republished. Do not use for writing a LinkedIn article or planning a content calendar. Related topics: marketing, business, linkedin.
What it will ask you for
- Article URL (free text, e.g. "Link to the article")
- Target audience (choose one: Professionals, Recruiters, Entrepreneurs, Students, Executives)
- Primary keyword (free text, e.g. "The phrase the article should rank for")
- Desired tone (choose one: Formal, Conversational, Inspirational, Technical)
- Length goal in words (number from 500 to 1500)
- Current engagement metrics (longer free text)
How it works
- Judge the headline for a specific promise and the opening two sentences for a hook aimed at the chosen audience.
- Check the primary keyword in the headline, first paragraph, and at least one subheading, and note stuffing or absence.
- Compare the article length with the goal and assess subheadings, visuals, and the closing call to action for skimmability and fit.
- Flag anything that conflicts with LinkedIn publishing guidelines.
- Write the six sections with an overall 1 to 5 rating in the Summary and a checklist of fixes in priority order.
What you get
A markdown report with Summary (including a 1 to 5 rating), Strengths, SEO and Keyword Gaps, Tone and Readability, Engagement Recommendations, and Checklist, all as bullet points.
What it watches out for
- Praising polish while missing that the headline makes no specific promise, the main reason an article is not opened.
- Recommending keyword repetition, which reads as spam to both readers and search.
- Treating low engagement as proof of poor writing when the audience or posting time may be the cause.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.