guide-recap

Transform CHANGELOG entries into social content (LinkedIn, Twitter/X, Newsletter, Slack) in FR + EN. Use after releases or weekly to generate release notes, announcements, social media posts, or recap summaries from guide updates.

Quality

92%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-crafted skill that provides a complete and actionable workflow for generating social media content from CHANGELOG entries. The progressive disclosure is excellent with clear references to supporting files, and the workflow is thoroughly specified with validation checkpoints and error handling. The only minor weakness is that some inline detail (scoring formula, categorization table, interactive mode flow) could potentially live in the referenced files to keep the SKILL.md leaner.

Dimension	Reasoning	Score
Conciseness	The skill is generally well-structured and avoids explaining basic concepts, but it's quite long (~180 lines) with some sections that could be tightened. The scoring formula, categorization tables, and interactive mode details are thorough but border on verbose for a SKILL.md overview that references external files for details.	2 / 3
Actionability	Highly actionable with concrete CLI commands, explicit scoring formulas, detailed parsing logic, clear flag definitions with defaults, and specific error handling responses. The workflow steps are precise enough for Claude to implement directly.	3 / 3
Workflow Clarity	The 7-step workflow is clearly sequenced with explicit decision points, error handling at each stage, a scoring threshold gate (step 5's score < 3 check), and the interactive mode is cleanly inserted as step 4b. The error handling table provides clear feedback loops for each failure mode.	3 / 3
Progressive Disclosure	Excellent structure with a clear overview, well-organized reference files section pointing to 10 specific files (templates, rules, examples) at one level deep. The SKILL.md serves as the orchestration overview while appropriately deferring detailed classification rules, tone guidelines, and transformation mappings to referenced files.	3 / 3
	Total	11 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong, well-crafted description that clearly communicates what the skill does (transforms CHANGELOG entries into multi-platform social content in two languages), when to use it (after releases or weekly), and includes rich trigger terms covering platforms, content types, and timing. The description is concise yet comprehensive, with a clear niche that minimizes conflict risk.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: transform CHANGELOG entries into social content across four named platforms (LinkedIn, Twitter/X, Newsletter, Slack), generate release notes, announcements, social media posts, and recap summaries. Also specifies bilingual output (FR + EN).	3 / 3
Completeness	Clearly answers both 'what' (transform CHANGELOG entries into social content in FR + EN across specific platforms) and 'when' ('Use after releases or weekly to generate release notes, announcements, social media posts, or recap summaries from guide updates').	3 / 3
Trigger Term Quality	Includes strong natural trigger terms users would say: 'CHANGELOG', 'release notes', 'announcements', 'social media posts', 'recap summaries', 'LinkedIn', 'Twitter/X', 'Newsletter', 'Slack', and 'releases'. These cover a good range of natural user language.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive niche: CHANGELOG-to-social-content transformation with specific platform targets and bilingual output. Unlikely to conflict with generic social media or generic changelog skills due to the specific combination of inputs, outputs, and languages.	3 / 3
	Total	12 / 12 Passed

Validation

90%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: FlorianBruniaux/claude-code-ultimate-guide
Commit: bbaa00d

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.