Agent skill

Changelog Social Recap

by FlorianBruniaux in FlorianBruniaux/claude-code-ultimate-guide

Turns CHANGELOG.md entries for a release or a week into LinkedIn, Twitter/X, newsletter and Slack posts in French and English.

CC-BY-SA-4.0Auto-check: notesWriting & Content

Install Changelog Social Recap

skills CLI
$ npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install FlorianBruniaux/claude-code-ultimate-guide guide-recap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/FlorianBruniaux/claude-code-ultimate-guide.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/guide-recap .claude/skills/guide-recap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
guide-recap
GitHub stars
6.1k
Token cost
~1.8k tokens
SKILL.md length
696 words
Files
10 (incl. references, assets)
Skills in repo
14
Repo updated
First seen
Licence
CC-BY-SA-4.0

At a glance

Turns CHANGELOG.md entries for a release or a week into LinkedIn, Twitter/X, newsletter and Slack posts in French and English.

  • Works in 7 steps: Parse Input → Extract CHANGELOG Entries → Categorize Entries → …
  • Announcing a freshly released version on LinkedIn, X, Slack or a newsletter
  • SKILL.md covers When to Use, Usage, Workflow (7 Steps) and Error Handling, plus 2 more sections
  • Reaches florianbruniaux.github.io and github.com

What it does

Given a command such as latest, a version number like v3.20.5, or week, the agent reads CHANGELOG.md from the project root and extracts the matching section. It sorts each top-level bullet into a weighted category, from new content and growth metrics down to research and fixes, so the strongest items lead the post. If a version or week has no entries, it lists recent versions or the date of the last release and suggests an alternative.

By default it produces eight drafts, four formats in two languages. Flags narrow the run to one format or one language, switch on an interactive mode for choosing the angle and audience, save the drafts under claudedocs/social-posts, or force a recap when only maintenance entries exist. Templates for each platform sit in an assets folder, with tone guidelines, changelog parsing rules and sample outputs in references and examples.

When your agent uses it

  • Announcing a freshly released version on LinkedIn, X, Slack or a newsletter
  • Writing a weekly roundup that covers several releases at once
  • Preparing the same release news in both French and English

Example prompts

  • “Recap the latest release for LinkedIn only, in English.”
  • “Run a weekly recap and save the drafts so I can review them.”
  • “Write the Slack and newsletter announcement for v3.20.5 in French.”

Requirements

  • A CHANGELOG.md at the project root with version headings
  • Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Parse Input
  2. Extract CHANGELOG Entries
  3. Categorize Entries
  4. Transform to User Value
  5. Score and Select
  6. Generate Content
  7. Output

What it can do on your machine

Read from SKILL.md and the folder at commit 585c203. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • florianbruniaux.github.io
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Changelog Social Recap loads about 1.8k tokens when it runs, and up to ~4.9k if it reads all its reference files. Until then it costs about 49 tokens; SKILL.md has 696 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from FlorianBruniaux/claude-code-ultimate-guide at commit 585c203, republished under its CC-BY-SA-4.0 licence (© FlorianBruniaux). 696 words, ~1,805 tokens.

Download SKILL.mdSave it as .claude/skills/guide-recap/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
guide-recap
description
Transform CHANGELOG entries into social content (LinkedIn, Twitter/X, Newsletter, Slack) in FR + EN. Use after releases or weekly to generate ready-to-post content from guide updates.
allowed-tools
Read, Bash
argument-hint
<latest|vX.Y.Z|week [YYYY-MM-DD]> [--interactive] [--format=linkedin|twitter|newsletter|slack] [--lang=fr|en] [--save]
effort
medium

Guide Recap

Generate social media content from CHANGELOG.md entries. Produces 8 outputs by default (4 formats x 2 languages).

When to Use

  • After running /release to create social announcements
  • Weekly to summarize multiple releases
  • Before posting on LinkedIn, Twitter/X, newsletter, or Slack

Usage

/guide-recap latest              # Latest released version
/guide-recap v3.20.5             # Specific version
/guide-recap week                # Current week (Monday to today)
/guide-recap week 2026-01-27     # Specific week (Monday to Sunday)
Flags
FlagEffectDefault
--interactiveGuide mode: choose angle, audience, highlightOff (auto-draft)
--format=XSingle format: linkedin, twitter, newsletter, slackAll 4 formats
--lang=XSingle language: fr, enBoth FR + EN
--saveSave output to claudedocs/social-posts/Display only
--forceGenerate even if only maintenance entriesSkip low-score

Workflow (7 Steps)

Step 1: Parse Input

Parse $ARGUMENTS to determine mode:

InputModeTarget
latestSingle versionFirst ## [X.Y.Z] after [Unreleased]
vX.Y.Z or X.Y.ZSingle versionExact version match
weekWeek rangeMonday of current week -> today
week YYYY-MM-DDWeek rangeThat Monday -> following Sunday

If no argument or invalid argument, display usage and exit.

Step 2: Extract CHANGELOG Entries

Read CHANGELOG.md from the project root.

Single version:

  1. Find line matching ## [{version}]
  2. Extract all content until next ## [ line
  3. Parse ### Added, ### Changed, ### Fixed sections

Week range:

  1. Collect all ## [X.Y.Z] - YYYY-MM-DD entries where date falls in range
  2. Parse all sections from all matching versions

Error: version not found -> List last 5 versions, suggest latest. Error: week has no entries -> Show date of last release, suggest that version.

Step 3: Categorize Entries

For each top-level entry (first-level bullet under ###), assign a category:

CategoryWeightDetection
NEW_CONTENT3New files, new sections, new diagrams, new quiz questions
GROWTH_METRIC2Line count growth, item count changes
RESEARCH1Resource evaluations, external source integrations
FIX1Under ### Fixed, corrections
MAINTENANCE0README updates, badge syncs, landing syncs, count updates

See references/changelog-parsing-rules.md for detailed classification rules.

Step 4: Transform to User Value

Apply mappings from references/content-transformation.md:

  • Technical language -> user benefit
  • Extract concrete numbers
  • Credit named sources
  • Cluster related entries

Validate against references/tone-guidelines.md DO/DON'T checklist.

Step 4b: Interactive Mode (--interactive only)

If --interactive flag is set, insert between steps 4 and 5:

  1. Display candidate highlights with scores:

    Highlights (by score):
    [14] 4 new ASCII diagrams (16 -> 20)     [NEW_CONTENT]
    [ 9] 30 new quiz questions (227 -> 257)   [NEW_CONTENT]
    [ 6] Docker sandbox isolation guide        [NEW_CONTENT]
    [ 1] README updated                        [MAINTENANCE]
  2. Ask angle:

    • Auto (highest scored = hook)
    • User picks specific entry as hook
    • Custom angle (user provides theme)
  3. Ask target audience:

    • devs (technical depth)
    • tech-leads (impact focus)
    • general (accessible language)
    • all (default, balanced)
  4. Ask primary highlight:

    • Auto (top score)
    • User selects from list
  5. Confirm selection and proceed to step 5.

Show full SKILL.md (307 more words)Show less
Step 5: Score and Select

Compute score for each entry:

score = (category_weight * 3)
      + (has_number * 2)
      + (named_source * 1)
      + (new_file * 1)
      + (min(impact_files, 3))
      + (breaking * 2)

Select top 3-4 entries by score. Highest score = hook line.

If all scores < 3: Output "No social content recommended for this version. Use --force to generate anyway." and exit (unless --force).

Step 6: Generate Content

For each requested format (default: all 4) and language (default: both):

  1. Read the corresponding template from assets/
  2. Fill template fields using scored and transformed entries
  3. Apply tone-guidelines.md quality checklist

Links:

FormatLink Target
LinkedInLanding site URL
TwitterGitHub repo URL
NewsletterBoth (landing + GitHub)
SlackGitHub repo URL

URLs:

  • Landing: https://florianbruniaux.github.io/Codex-ultimate-guide-landing/
  • GitHub: https://github.com/FlorianBruniaux/Codex-ultimate-guide
Step 7: Output

Display each generated post in a fenced code block, labeled by format and language:

## LinkedIn (FR)

```text
[content]
`` `

## LinkedIn (EN)

```text
[content]
`` `

## Twitter/X (FR)

```text
[content]
`` `

...

If --save flag: write all outputs to claudedocs/social-posts/YYYY-MM-DD-vX.Y.Z.md (for version) or claudedocs/social-posts/YYYY-MM-DD-week.md (for week). Create claudedocs/social-posts/ directory if it doesn't exist.

Error Handling

ErrorResponse
No argumentDisplay usage block
Invalid argumentDisplay usage block with examples
Version not foundList 5 most recent versions, suggest latest
Week has no entriesShow date of last release, suggest version
All entries MAINTENANCE (score 0)"No social content recommended. Use --force to override."
CHANGELOG.md not found"CHANGELOG.md not found in project root."

Reference Files

  • references/tone-guidelines.md - DO/DON'T rules, emoji budget, language register
  • references/changelog-parsing-rules.md - CHANGELOG format, extraction, scoring algorithm
  • references/content-transformation.md - Technical -> user value mappings (30+)
  • assets/linkedin-template.md - ~1300 chars, hook + bullets + CTA + hashtags
  • assets/twitter-template.md - 280 chars single or 2-3 tweet thread
  • assets/newsletter-template.md - ~500 words, structured sections
  • assets/slack-template.md - Compact, emoji-rich, Slack formatting
  • examples/version-output.md - Full example output for v3.20.5
  • examples/week-output.md - Full example output for week 2026-01-27

Tips

  • Run /guide-recap latest right after /release to prepare social posts
  • Use --interactive the first few times to understand the scoring
  • Use --format=linkedin --lang=fr when you only need one specific output
  • --save outputs are gitignored via claudedocs/ convention
  • Review and personalize before posting (these are drafts, not final copy)

© FlorianBruniaux, CC-BY-SA-4.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (references, assets) in .agents/skills/guide-recap of FlorianBruniaux/claude-code-ultimate-guide.

  • SKILL.md
  • assets/linkedin-template.md
  • assets/newsletter-template.md
  • assets/slack-template.md
  • assets/twitter-template.md
  • examples/version-output.md
  • examples/week-output.md
  • references/changelog-parsing-rules.md
  • references/content-transformation.md
  • references/tone-guidelines.md

Open the folder on GitHubat commit 585c203

Compare with similar skills

Changelog Social Recap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Changelog Social Recap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Changelog Social Recap this skillFlorianBruniaux/claude-code-ultimate-guide6.1k—~1.8kAutomated safety check: NotesCC-BY-SA-4.0
Content Repurposer Smsblacktwist/social-media-skills559—~3.7kAutomated safety check: PassMIT
Podcast Pipelineericosiu/ai-marketing-skills3.6k1 repos~2.6kAutomated safety check: PassMIT
Repurpose Into A Postsickn33/agentic-awesome-skills47k1 repos~1.6kAutomated safety check: PassMIT
Content RepurposerAffitor/affiliate-skills700—~2.6kAutomated safety check: PassMIT
Content Repurposerinfometa/workbuddyskills346—~2.2kAutomated safety check: PassNone

Similar skills

  • Content Repurposer Sms

    blacktwist/social-media-skills

    When the user wants to turn one piece of content into multiple formats or adapt content across text-first and visual-first platforms (LinkedIn, Twitter/X, Threads, Bluesky, Facebook, Instagram…

    559 GitHub stars~3.7k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Podcast Pipeline

    ericosiu/ai-marketing-skills

    Podcast-to-Everything content pipeline. An agent skill from ericosiu/ai-marketing-skills.

    3.6k GitHub starsUsed in 1 repo~2.6k tokens
    Writing & ContentAuto-check passed
  • Repurpose Into A Post

    sickn33/agentic-awesome-skills

    Turn an article, newsletter, transcript or video into a Twitter/X or LinkedIn post that stands on its own.

    47k GitHub starsUsed in 1 repo~1.6k tokens
    Writing & ContentAuto-check passed
  • Content Repurposer

    Affitor/affiliate-skills

    Repurpose one piece of affiliate content into multiple formats.

    700 GitHub stars~2.6k tokensUpdated 25 days ago
    Writing & ContentAuto-check passed
  • Content Repurposer

    infometa/workbuddyskills

    Transform long-form content into platform-optimized snippets.

    346 GitHub stars~2.2k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Repurpose Into A Post

    aiskillstore/marketplace

    Turn an article, newsletter, transcript, video or long document into a Twitter or LinkedIn post that stands on its own.

    430 GitHub starsUsed in 1 repo~919 tokens
    Writing & ContentAuto-check passed

More from FlorianBruniaux/claude-code-ultimate-guide

All 14 skills in this repo
  • Codex Skill Self-Assessment

    FlorianBruniaux/claude-code-ultimate-guide

    Runs an interactive quiz in a quick or comprehensive mode, scores your skill level by topic and generates a personalized learning path with practice projects.

    6.1k GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check passed
  • Whitepaper Bare Section Prose Filler

    FlorianBruniaux/claude-code-ultimate-guide

    Adds two to four sentences of intro prose before each bare heading in the French and English whitepapers, splitting the work across nine parallel agents.

    6.1k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Audit Whitepapers

    FlorianBruniaux/claude-code-ultimate-guide

    Audits version freshness, French and English parity and metadata of whitepapers and recap cards in the claude-code-ultimate-guide repo, with optional fix suggestions.

    6.1k GitHub stars~3.8k tokensUpdated 2 days ago
    Auto-check passed
  • Methodology Advisor

    FlorianBruniaux/claude-code-ultimate-guide

    Reads a codebase silently, asks only what it cannot infer, and recommends one AI-assisted development methodology stack with a contextual quick start.

    6.1k GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed
  • Guide and Landing Sync Check

    FlorianBruniaux/claude-code-ultimate-guide

    Check guide/landing synchronization status

    6.1k GitHub stars~692 tokensUpdated 2 days ago
    Auto-check passed
  • Track Online Mentions

    FlorianBruniaux/claude-code-ultimate-guide

    Searches the web for new mentions of the Claude Code Ultimate Guide or its author's public projects, checks them against YAML trackers and reports or adds the new ones.

    6.1k GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed

Questions about Changelog Social Recap

What does Changelog Social Recap do?

Turns CHANGELOG.md entries for a release or a week into LinkedIn, Twitter/X, newsletter and Slack posts in French and English. md from the project root and extracts the matching section. It sorts each top-level bullet into a weighted category, from new content and growth metrics down to research and fixes, so the strongest items lead the post.

When should I use Changelog Social Recap?

Changelog Social Recap fits situations like: announcing a freshly released version on LinkedIn, X, Slack or a newsletter; writing a weekly roundup that covers several releases at once; preparing the same release news in both French and English.

How do I install Changelog Social Recap in Claude Code?

Run `npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a claude-code`. Or copy the skill folder (.agents/skills/guide-recap in FlorianBruniaux/claude-code-ultimate-guide) into .claude/skills/guide-recap in your project. Claude Code loads it when a task matches its description.

How do I install Changelog Social Recap in Codex?

Run `npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a codex`. Or copy the skill folder (.agents/skills/guide-recap in FlorianBruniaux/claude-code-ultimate-guide) into .agents/skills/guide-recap in your project. Codex loads it when a task matches its description.

Can I use Changelog Social Recap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill guide-recap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/guide-recap, .gemini/skills/guide-recap, .github/skills/guide-recap and .opencode/skills/guide-recap in your project.

What does Changelog Social Recap need to run?

SKILL.md names no scripts, command-line tools or credentials: Changelog Social Recap is instructions for the agent only. Our summary lists: A CHANGELOG.md at the project root with version headings. Its frontmatter pre-approves these tools: Read, Bash.

Does Changelog Social Recap access the network?

SKILL.md names 2 domains. In commands or code: florianbruniaux.github.io and github.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Changelog Social Recap safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Changelog Social Recap use?

Changelog Social Recap is published under the CC-BY-SA-4.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Changelog Social Recap use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.1k tokens, read only when the agent opens those files.

What are the alternatives to Changelog Social Recap?

Skills that share tags, products or a category with Changelog Social Recap: Content Repurposer Sms (blacktwist/social-media-skills, 559 stars), Podcast Pipeline (ericosiu/ai-marketing-skills, 3.6k stars), Repurpose Into A Post (sickn33/agentic-awesome-skills, 47k stars) and Content Repurposer (Affitor/affiliate-skills, 700 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Changelog Social Recap?

FlorianBruniaux (a GitHub user) maintains it in FlorianBruniaux/claude-code-ultimate-guide, which has 6,128 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.

Source: FlorianBruniaux/claude-code-ultimate-guide on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.