# guide-recap

guide-recap is a Claude Code skill that turns CHANGELOG.md entries into draft posts for LinkedIn, Twitter/X, newsletters, and Slack. Run it after a release or for a weekly recap.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 6529 repo stars
- Author: FlorianBruniaux
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.agents/skills/guide-recap/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/guide-recap

## What it does

The skill reads `CHANGELOG.md` from the project root and gathers entries for a chosen release or date range. It drafts content for four channels, with French and English versions by default. You can request one format or language instead.

Entries are grouped and scored before the skill picks updates for the posts. Its `--interactive` mode lets you choose the angle, audience, and main highlight. That gives you a say in which changes lead the recap.

Results appear in code blocks. Add `--save` to write them under `claudedocs/social-posts/`. The project needs a root-level `CHANGELOG.md`; without that file, the skill has no release entries to turn into posts.

## Requirements
- Works with: Slack, LinkedIn

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install FlorianBruniaux/claude-code-ultimate-guide .agents/skills/guide-recap
```

2. **Manually: put the files in place**
- File: `.github/skills/guide-recap/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/FlorianBruniaux/claude-code-ultimate-guide --path .agents/skills/guide-recap
```

### Windsurf (Devin Desktop)

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

### 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/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.agents/skills/guide-recap/SKILL.md

## When to use it
- draft posts from the latest release
- recap a week's changes across channels
- adapt release notes for Slack or LinkedIn
- save generated posts in the project

## Example prompts
- Draft posts for the latest release: `/guide-recap latest`.
- Create a weekly Slack recap: `/guide-recap week --format=slack`.
- Let me choose the audience and lead for `v3.20.5`: `/guide-recap v3.20.5 --interactive`.

## Similar
- [postiz](https://affpapa.org/en/nevibecode/skills/postiz.md) — skill · 5700 installs
- [brand-voice-enforcement](https://affpapa.org/en/nevibecode/skills/brand-voice-enforcement.md) — skill · 3900 installs
- [social](https://affpapa.org/en/nevibecode/skills/social.md) — skill · 100700 installs
- [LinkDeal](https://affpapa.org/en/nevibecode/mcp/linkdeal.md) — MCP server
- [content-rewrite](https://affpapa.org/en/nevibecode/skills/content-rewrite.md) — skill · 4000 installs
- [linkedin-posts](https://affpapa.org/en/nevibecode/skills/linkedin-posts.md) — skill · 3700 installs

From the same set: [florianbruniaux/claude-code-ultimate-guide](https://affpapa.org/en/nevibecode/by/florianbruniaux/claude-code-ultimate-guide.md) — 45 cards

---
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
