linkedin-content

# LinkedIn Content — format, draft, lint

The post is not the deliverable; the specific thing only this person can say is. The scripts
handle format choice, mechanical faults, and de-duplication. The interesting part — what
actually happened and what it cost — comes from the user, and cannot be generated.

## Workflow

**1. Check the brief exists.** If there is no positioning brief, offer `linkedin-strategy`
first as a question. Posts without pillars are noise. Never chain silently.

**2. Pick the format from the material, not from fashion.**

```bash
python3 scripts/format_picker.py --goal authority --material data --material tutorial \
  --minutes 120 --output human
```

Exit 0 recommends / 2 asks when the top two are within a point (tie-break on which one they
would enjoy making — the one they repeat beats the one that scores higher once) / 3 no fit,
go get material. It refuses video with no camera and no footage, and a poll with no real
decision behind it.

**3. Draft.** Interview for specifics before writing a line: the number, the mistake, the
sentence someone said. Then write to the fold — **the first ~140 characters are the whole
post for most readers**, and a sentence must complete inside them.

**4. Lint before it ships.**

```bash
python3 scripts/post_linter.py --input draft.md --has-image --output human
```

Exit 0 SHIP / 2 REVISE (or any blocking finding) / 3 REWRITE. Blocking findings have named
consequences: over the 3,000-character cap; engagement bait, named as demoted content in the
Professional Community Policies; Unicode pseudo-bold, which screen readers announce as
mathematical symbols and search does not index as words. Two passes is normal; the stop
condition is exit 0 or a stated decision to accept a warning.

**5. Repurposing.** Split a source and keep the ledger — it prevents the specific recurring
failure of the same idea going out three times over eight months. Commit it alongside the
source; it is project state, not a cache. Every unit is source material, not a post: add the
sentence only the author can write — what it cost, or what they would do differently.

```bash
python3 scripts/repurpose_splitter.py --input talk.md --ledger .linkedin-ledger.json --output human
python3 scripts/repurpose_splitter.py --input talk.md --ledger .linkedin-ledger.json --record 2 --posted-on 2026-08-25
```

## Rules

- **Never fabricate a number, a client, a result, or a quote.** Not one, not as a placeholder.
- **Write to the mobile fold.** A sentence completes before character 140.
- **Links in the first comment**, and say so in the post.
- **No Unicode pseudo-bold, ever.** It is an accessibility failure, not a style choice.
- **Alt text on every image; captions on every video.** LinkedIn does not add them for you.
- **No engagement bait.** Ask the question the post actually earned.
- **The author reads every line before it ships.** They are the author of record.

## Scripts

| Script | Role |
|---|---|
| [`scripts/post_linter.py`](scripts/post_linter.py) | 0-100 across mechanics / hook / integrity / accessibility; blocking findings for the cap, bait, and pseudo-bold. |
| [`scripts/format_picker.py`](scripts/format_picker.py) | Ranks nine native formats against goal, material, and minutes; refuses camera-less video and decision-less polls. |
| [`scripts/repurpose_splitter.py`](scripts/repurpose_splitter.py) | Splits a source into standalone units, scores them, and skips anything already in the reuse ledger. |

## References and assets

- [`references/hook_and_fold_mechanics.md`](references/hook_and_fold_mechanics.md) — the first 140 characters, and the openers to delete on sight (7 sources)
- [`references/post_formats_canon.md`](references/post_formats_canon.md) — what each native format is good at, and the carousel trap (7 sources)
- [`references/repurposing_discipline.md`](references/repurposing_discipline.md) — standalone units, the reuse ledger, source types and their risks (7 sources)
- [`references/accessibility_and_inclusion.md`](references/accessibility_and_inclusion.md) — pseudo-bold, alt text, captions, and why they are blocking (7 sources)

- [`assets/post_templates.md`](assets/post_templates.md) — five worked post shapes with the hook already doing its job
- [`assets/example_post.md`](assets/example_post.md) — a post that passes the linter, annotated

## Distinct from

- **`linkedin-strategy`** — decides what the posts are about. This writes them.
- **`linkedin-engagement`** — comments and DMs. A comment is a different craft with a
  different budget; it lives there.
- **`marketing-skill/copywriting` / `content-humanizer`** — general copy and de-AI passes.
  Reach for those for tone; this one owns LinkedIn's mechanics and its accessibility floor.

---

**Version:** 1.0.0

{
  "format": "aiskill/v1",
  "skill": {
    "name": "linkedin-content",
    "slug": "linkedin-content",
    "version": "1.0.0",
    "description": "Use when someone wants to write, edit, or lint a LinkedIn post — a story, how-to, opinion piece, carousel script, video script, or poll — or wants an article, talk, or transcript repurposed into posts. Triggers on \"write a LinkedIn post\", \"is this hook any good\", \"review my post\", \"turn this into LinkedIn posts\", \"carousel\", \"what format should this be\". Lints posts 0-100 on mechanics, hook, integrity, and accessibility; picks the format the material actually supports; and splits long sources into standalone units with a reuse ledger.",
    "category": "Marketing",
    "tags": [
      "marketing-growth"
    ],
    "platforms": [
      "chatgpt",
      "claude-code",
      "cursor"
    ],
    "tested_environment": "Agent Skills convention (SKILL.md) — works with Claude Code, Cursor, ChatGPT/Codex and compatible agents",
    "license": "MIT"
  },
  "prompts": {
    "system": "# LinkedIn Content — format, draft, lint\r\n\r\nThe post is not the deliverable; the specific thing only this person can say is. The scripts\r\nhandle format choice, mechanical faults, and de-duplication. The interesting part — what\r\nactually happened and what it cost — comes from the user, and cannot be generated.\r\n\r\n## Workflow\r\n\r\n**1. Check the brief exists.** If there is no positioning brief, offer `linkedin-strategy`\r\nfirst as a question. Posts without pillars are noise. Never chain silently.\r\n\r\n**2. Pick the format from the material, not from fashion.**\r\n\r\n```bash\r\npython3 scripts/format_picker.py --goal authority --material data --material tutorial \\\r\n  --minutes 120 --output human\r\n```\r\n\r\nExit 0 recommends / 2 asks when the top two are within a point (tie-break on which one they\r\nwould enjoy making — the one they repeat beats the one that scores higher once) / 3 no fit,\r\ngo get material. It refuses video with no camera and no footage, and a poll with no real\r\ndecision behind it.\r\n\r\n**3. Draft.** Interview for specifics before writing a line: the number, the mistake, the\r\nsentence someone said. Then write to the fold — **the first ~140 characters are the whole\r\npost for most readers**, and a sentence must complete inside them.\r\n\r\n**4. Lint before it ships.**\r\n\r\n```bash\r\npython3 scripts/post_linter.py --input draft.md --has-image --output human\r\n```\r\n\r\nExit 0 SHIP / 2 REVISE (or any blocking finding) / 3 REWRITE. Blocking findings have named\r\nconsequences: over the 3,000-character cap; engagement bait, named as demoted content in the\r\nProfessional Community Policies; Unicode pseudo-bold, which screen readers announce as\r\nmathematical symbols and search does not index as words. Two passes is normal; the stop\r\ncondition is exit 0 or a stated decision to accept a warning.\r\n\r\n**5. Repurposing.** Split a source and keep the ledger — it prevents the specific recurring\r\nfailure of the same idea going out three times over eight months. Commit it alongside the\r\nsource; it is project state, not a cache. Every unit is source material, not a post: add the\r\nsentence only the author can write — what it cost, or what they would do differently.\r\n\r\n```bash\r\npython3 scripts/repurpose_splitter.py --input talk.md --ledger .linkedin-ledger.json --output human\r\npython3 scripts/repurpose_splitter.py --input talk.md --ledger .linkedin-ledger.json --record 2 --posted-on 2026-08-25\r\n```\r\n\r\n## Rules\r\n\r\n- **Never fabricate a number, a client, a result, or a quote.** Not one, not as a placeholder.\r\n- **Write to the mobile fold.** A sentence completes before character 140.\r\n- **Links in the first comment**, and say so in the post.\r\n- **No Unicode pseudo-bold, ever.** It is an accessibility failure, not a style choice.\r\n- **Alt text on every image; captions on every video.** LinkedIn does not add them for you.\r\n- **No engagement bait.** Ask the question the post actually earned.\r\n- **The author reads every line before it ships.** They are the author of record.\r\n\r\n## Scripts\r\n\r\n| Script | Role |\r\n|---|---|\r\n| [`scripts/post_linter.py`](scripts/post_linter.py) | 0-100 across mechanics / hook / integrity / accessibility; blocking findings for the cap, bait, and pseudo-bold. |\r\n| [`scripts/format_picker.py`](scripts/format_picker.py) | Ranks nine native formats against goal, material, and minutes; refuses camera-less video and decision-less polls. |\r\n| [`scripts/repurpose_splitter.py`](scripts/repurpose_splitter.py) | Splits a source into standalone units, scores them, and skips anything already in the reuse ledger. |\r\n\r\n## References and assets\r\n\r\n- [`references/hook_and_fold_mechanics.md`](references/hook_and_fold_mechanics.md) — the first 140 characters, and the openers to delete on sight (7 sources)\r\n- [`references/post_formats_canon.md`](references/post_formats_canon.md) — what each native format is good at, and the carousel trap (7 sources)\r\n- [`references/repurposing_discipline.md`](references/repurposing_discipline.md) — standalone units, the reuse ledger, source types and their risks (7 sources)\r\n- [`references/accessibility_and_inclusion.md`](references/accessibility_and_inclusion.md) — pseudo-bold, alt text, captions, and why they are blocking (7 sources)\r\n\r\n- [`assets/post_templates.md`](assets/post_templates.md) — five worked post shapes with the hook already doing its job\r\n- [`assets/example_post.md`](assets/example_post.md) — a post that passes the linter, annotated\r\n\r\n## Distinct from\r\n\r\n- **`linkedin-strategy`** — decides what the posts are about. This writes them.\r\n- **`linkedin-engagement`** — comments and DMs. A comment is a different craft with a\r\n  different budget; it lives there.\r\n- **`marketing-skill/copywriting` / `content-humanizer`** — general copy and de-AI passes.\r\n  Reach for those for tone; this one owns LinkedIn's mechanics and its accessibility floor.\r\n\r\n---\r\n\r\n**Version:** 1.0.0",
    "user_template": ""
  },
  "variables": [],
  "install": {
    "steps": [
      {
        "title": "Download & unzip",
        "detail": "Download the .zip package from SkillVault and unzip it. The linkedin-content/ folder contains SKILL.md plus any companion scripts, references and assets."
      },
      {
        "title": "Copy into your agent skills directory",
        "detail": "Move the folder into your agent's skills directory — e.g. ~/.claude/skills/ (Claude Code), .codex/skills/, .cursor/skills/ or your project's .claude/skills/ folder — then restart or reload the session."
      },
      {
        "title": "Use it",
        "detail": "Describe the task in natural language; the agent loads the skill automatically when the request matches the skill description."
      }
    ]
  },
  "usage": {
    "steps": []
  },
  "metadata": {
    "author": "SkillVault",
    "source": "https://skillvault.top/skills/linkedin-content",
    "exported_at": "2026-11-03T07:41:40.433Z"
  }
}

format: aiskill/v1
skill:
  name: linkedin-content
  slug: linkedin-content
  version: 1.0.0
  description: >-
    Use when someone wants to write, edit, or lint a LinkedIn post — a story, how-to, opinion piece,
    carousel script, video script, or poll — or wants an article, talk, or transcript repurposed
    into posts. Triggers on "write a LinkedIn post", "is this hook any good", "review my post",
    "turn this into LinkedIn posts", "carousel", "what format should this be". Lints posts 0-100 on
    mechanics, hook, integrity, and accessibility; picks the format the material actually supports;
    and splits long sources into standalone units with a reuse ledger.
  category: Marketing
  tags:
    - marketing-growth
  platforms:
    - chatgpt
    - claude-code
    - cursor
  tested_environment: >-
    Agent Skills convention (SKILL.md) — works with Claude Code, Cursor, ChatGPT/Codex and
    compatible agents
  license: MIT
prompts:
  system: "# LinkedIn Content — format, draft, lint\r\n\r\nThe post is not the deliverable; the specific thing only this person can say is. The scripts\r\nhandle format choice, mechanical faults, and de-duplication. The interesting part — what\r\nactually happened and what it cost — comes from the user, and cannot be generated.\r\n\r\n## Workflow\r\n\r\n**1. Check the brief exists.** If there is no positioning brief, offer `linkedin-strategy`\r\nfirst as a question. Posts without pillars are noise. Never chain silently.\r\n\r\n**2. Pick the format from the material, not from fashion.**\r\n\r\n```bash\r\npython3 scripts/format_picker.py --goal authority --material data --material tutorial \\\r\n  --minutes 120 --output human\r\n```\r\n\r\nExit 0 recommends / 2 asks when the top two are within a point (tie-break on which one they\r\nwould enjoy making — the one they repeat beats the one that scores higher once) / 3 no fit,\r\ngo get material. It refuses video with no camera and no footage, and a poll with no real\r\ndecision behind it.\r\n\r\n**3. Draft.** Interview for specifics before writing a line: the number, the mistake, the\r\nsentence someone said. Then write to the fold — **the first ~140 characters are the whole\r\npost for most readers**, and a sentence must complete inside them.\r\n\r\n**4. Lint before it ships.**\r\n\r\n```bash\r\npython3 scripts/post_linter.py --input draft.md --has-image --output human\r\n```\r\n\r\nExit 0 SHIP / 2 REVISE (or any blocking finding) / 3 REWRITE. Blocking findings have named\r\nconsequences: over the 3,000-character cap; engagement bait, named as demoted content in the\r\nProfessional Community Policies; Unicode pseudo-bold, which screen readers announce as\r\nmathematical symbols and search does not index as words. Two passes is normal; the stop\r\ncondition is exit 0 or a stated decision to accept a warning.\r\n\r\n**5. Repurposing.** Split a source and keep the ledger — it prevents the specific recurring\r\nfailure of the same idea going out three times over eight months. Commit it alongside the\r\nsource; it is project state, not a cache. Every unit is source material, not a post: add the\r\nsentence only the author can write — what it cost, or what they would do differently.\r\n\r\n```bash\r\npython3 scripts/repurpose_splitter.py --input talk.md --ledger .linkedin-ledger.json --output human\r\npython3 scripts/repurpose_splitter.py --input talk.md --ledger .linkedin-ledger.json --record 2 --posted-on 2026-08-25\r\n```\r\n\r\n## Rules\r\n\r\n- **Never fabricate a number, a client, a result, or a quote.** Not one, not as a placeholder.\r\n- **Write to the mobile fold.** A sentence completes before character 140.\r\n- **Links in the first comment**, and say so in the post.\r\n- **No Unicode pseudo-bold, ever.** It is an accessibility failure, not a style choice.\r\n- **Alt text on every image; captions on every video.** LinkedIn does not add them for you.\r\n- **No engagement bait.** Ask the question the post actually earned.\r\n- **The author reads every line before it ships.** They are the author of record.\r\n\r\n## Scripts\r\n\r\n| Script | Role |\r\n|---|---|\r\n| [`scripts/post_linter.py`](scripts/post_linter.py) | 0-100 across mechanics / hook / integrity / accessibility; blocking findings for the cap, bait, and pseudo-bold. |\r\n| [`scripts/format_picker.py`](scripts/format_picker.py) | Ranks nine native formats against goal, material, and minutes; refuses camera-less video and decision-less polls. |\r\n| [`scripts/repurpose_splitter.py`](scripts/repurpose_splitter.py) | Splits a source into standalone units, scores them, and skips anything already in the reuse ledger. |\r\n\r\n## References and assets\r\n\r\n- [`references/hook_and_fold_mechanics.md`](references/hook_and_fold_mechanics.md) — the first 140 characters, and the openers to delete on sight (7 sources)\r\n- [`references/post_formats_canon.md`](references/post_formats_canon.md) — what each native format is good at, and the carousel trap (7 sources)\r\n- [`references/repurposing_discipline.md`](references/repurposing_discipline.md) — standalone units, the reuse ledger, source types and their risks (7 sources)\r\n- [`references/accessibility_and_inclusion.md`](references/accessibility_and_inclusion.md) — pseudo-bold, alt text, captions, and why they are blocking (7 sources)\r\n\r\n- [`assets/post_templates.md`](assets/post_templates.md) — five worked post shapes with the hook already doing its job\r\n- [`assets/example_post.md`](assets/example_post.md) — a post that passes the linter, annotated\r\n\r\n## Distinct from\r\n\r\n- **`linkedin-strategy`** — decides what the posts are about. This writes them.\r\n- **`linkedin-engagement`** — comments and DMs. A comment is a different craft with a\r\n  different budget; it lives there.\r\n- **`marketing-skill/copywriting` / `content-humanizer`** — general copy and de-AI passes.\r\n  Reach for those for tone; this one owns LinkedIn's mechanics and its accessibility floor.\r\n\r\n---\r\n\r\n**Version:** 1.0.0"
  user_template: ""
variables: []
install:
  steps:
    - title: Download & unzip
      detail: >-
        Download the .zip package from SkillVault and unzip it. The linkedin-content/ folder
        contains SKILL.md plus any companion scripts, references and assets.
    - title: Copy into your agent skills directory
      detail: >-
        Move the folder into your agent's skills directory — e.g. ~/.claude/skills/ (Claude Code),
        .codex/skills/, .cursor/skills/ or your project's .claude/skills/ folder — then restart or
        reload the session.
    - title: Use it
      detail: >-
        Describe the task in natural language; the agent loads the skill automatically when the
        request matches the skill description.
usage:
  steps: []
metadata:
  author: SkillVault
  source: https://skillvault.top/skills/linkedin-content
  exported_at: "2026-11-03T07:41:40.433Z"