# writing-linkedin-posts

Guides an agent through writing LinkedIn posts: hook, body, close. Useful when you want a first-person text, not an ad template.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 647 installs · ★ 21
- Author: jamesgray007
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jamesgray007/hoai-course/tree/HEAD/.claude/skills/writing-linkedin-posts/SKILL.md
- Updated: 2025-12-19
- HTML: https://affpapa.org/en/nevibecode/skills/writing-linkedin-posts

## What it does

The skill sets boundaries for LinkedIn writing. Inside are principles: one idea per post, value without engagement bait, honest reflection instead of performed vulnerability. The agent breaks a post into parts: the hook in the first lines before "See more", the body, the close.

Ready-made frameworks cover several formats: story, list, contrarian take, observation. A table shows which hooks still work and which to retire. For personal stories there is a set of questions to answer before publishing.

The skill points to `references/hooks.md` with hook examples. Worth installing if you run your own LinkedIn account and want the agent to keep your tone instead of producing motivational posters.

## Requirements
- Works with: LinkedIn

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jamesgray007/hoai-course --skill writing-linkedin-posts -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/writing-linkedin-posts/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/writing-linkedin-posts/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jamesgray007/hoai-course --skill writing-linkedin-posts -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/writing-linkedin-posts/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jamesgray007/hoai-course --skill writing-linkedin-posts -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/writing-linkedin-posts/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jamesgray007/hoai-course writing-linkedin-posts
```

2. **Manually: put the files in place**
- File: `.github/skills/writing-linkedin-posts/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jamesgray007/hoai-course --skill writing-linkedin-posts -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jamesgray007/hoai-course --path .claude/skills/writing-linkedin-posts
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/writing-linkedin-posts/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jamesgray007/hoai-course --skill writing-linkedin-posts -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jamesgray007/hoai-course/tree/HEAD/.claude/skills/writing-linkedin-posts/SKILL.md

## When to use it
- write a first-person LinkedIn post
- come up with a hook that does not read like an ad
- turn a work story into a post structure
- check whether a draft slid into engagement bait
- pick a format: list, observation or contrarian take

## Example prompts
- Write a LinkedIn post about how I rewrote our service architecture
- Give me a hook for a post about being wrong on remote work
- Review my draft post: where is the engagement bait?

## Similar
- [linkedin-content](https://affpapa.org/en/nevibecode/skills/linkedin-content.md) — skill · 26 installs
- [linkedin-posts](https://affpapa.org/en/nevibecode/skills/linkedin-posts.md) — skill · 3600 installs
- [linkedin-post-writer](https://affpapa.org/en/nevibecode/skills/linkedin-post-writer.md) — skill · 628 installs
- [LinkedIn Automation](https://affpapa.org/en/nevibecode/skills/linkedin-automation.md) — skill · 5100 installs
- [linkedin-company-pages](https://affpapa.org/en/nevibecode/skills/linkedin-company-pages.md) — skill · 599 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md