feat: Add readme-enhance skill and /github-social:all command

New readme-enhance skill:
- Generates shields.io badges based on project analysis
- Creates NotebookLM-style infographic prompts
- Hybrid style adapts to project type
- Direct README.md modification support

New commands:
- /readme-enhance - Add badges and infographic to README
- /github-social:all - Run all skills in sequence

Also includes:
- Comprehensive reference docs (badge catalog, infographic prompts)
- Working examples for different project types
- CHANGELOG.md following Keep a Changelog format
- Version bump to 0.4.0

Author: zircote

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "github-social",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Optimize GitHub repository presentation with social preview images and engaging metadata (descriptions, topics)",
   "author": {
     "name": "zircote"

CHANGELOG.md

@@ -0,0 +1,80 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.4.0] - 2025-01-18
+
+### Added
+
+- **[readme-enhance]**: New skill for README enhancement with marketing badges and infographics
+  - Generates shields.io badges based on project analysis (version, build, license, downloads, language, etc.)
+  - Creates NotebookLM-style infographic prompts capturing architecture and features
+  - Hybrid infographic style adapts to project type (CLI, library, framework, app, infrastructure)
+  - Direct README.md modification with intelligent badge section management
+  - Comprehensive reference documentation for badge patterns and infographic prompts
+- **[/readme-enhance]**: New command to enhance README with badges and infographic
+  - Supports `--badges-only`, `--infographic-only`, and `--dry-run` flags
+- **[/github-social:all]**: New command to run all skills in sequence
+  - Executes repo-metadata, social-preview, and readme-enhance in order
+  - Supports `--apply`, `--dry-run`, `--skip-badges`, and `--skip-infographic` flags
+  - Shared project analysis for efficiency
+
+### Changed
+
+- Updated plugin version to 0.4.0
+- Enhanced README documentation with new features and commands
+
+## [0.3.0] - 2025-01-18
+
+### Added
+
+- **[social-preview]**: Added `upload_to_repo` option to automatically upload generated images to GitHub repository
+  - Uses GitHub MCP tool for seamless integration
+  - Configurable via `.claude/github-social.local.md`
+- **[CI/CD]**: Added GitHub Actions workflow and templates
+  - Pull request template
+  - Copilot instructions
+
+### Changed
+
+- Improved social preview skill workflow documentation
+
+## [0.2.0] - 2025-01-18
+
+### Added
+
+- **[repo-metadata]**: New skill for generating optimized repository descriptions and topics
+  - SEO-friendly descriptions (max 350 chars)
+  - Topic suggestions for discoverability (max 20 topics)
+  - Apply changes via `gh` CLI or output for manual review
+- **[/repo-metadata]**: New command with `--apply` flag for direct GitHub updates
+- GitHub activity badges in README (stars, issues, last commit, PRs welcome)
+
+### Changed
+
+- Updated badge URLs for renamed repository
+
+## [0.1.0] - 2025-01-18
+
+### Added
+
+- **[social-preview]**: Initial skill for generating GitHub social preview images
+  - Analyzes project files (README, package.json, CLAUDE.md) to understand purpose
+  - Generates detailed image prompts capturing project spirit
+  - Supports multiple providers (DALL-E, Stable Diffusion, Midjourney, manual)
+  - Outputs images meeting GitHub requirements (1280x640px, <1MB)
+- **[/social-preview]**: Command to generate social preview images
+- **[/github-social:setup]**: Interactive setup wizard for configuration
+- Configuration via `.claude/github-social.local.md` with YAML frontmatter
+- MIT License
+
+[Unreleased]: https://github.com/zircote/github-social/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/zircote/github-social/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/zircote/github-social/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/zircote/github-social/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/zircote/github-social/releases/tag/v0.1.0

README.md

@@ -2,7 +2,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-blueviolet)](https://claude.ai/claude-code)
-[![Version](https://img.shields.io/badge/version-0.2.0-green.svg)](.claude-plugin/plugin.json)
+[![Version](https://img.shields.io/badge/version-0.4.0-green.svg)](.claude-plugin/plugin.json)
 [![GitHub Stars](https://img.shields.io/github/stars/zircote/github-social?style=social)](https://github.com/zircote/github-social)
 [![GitHub Issues](https://img.shields.io/github/issues/zircote/github-social)](https://github.com/zircote/github-social/issues)
 [![Last Commit](https://img.shields.io/github/last-commit/zircote/github-social)](https://github.com/zircote/github-social/commits)
@@ -24,6 +24,13 @@ A Claude Code plugin that optimizes GitHub repository presentation by analyzing
 - Can apply changes directly via `gh` CLI or output for manual review
 - Works with zero configuration
 
+### README Enhancement
+- Generates marketing badges (shields.io) based on project analysis
+- Creates NotebookLM-style infographic prompts capturing architecture and features
+- Supports multiple badge types: version, build, license, downloads, language, and more
+- Hybrid infographic style adapts to project type (CLI, library, framework, app)
+- Direct README.md modification with intelligent badge section management
+
 ## Installation
 
 ```bash
@@ -128,13 +135,25 @@ Generates optimized repository descriptions and topics. Triggered by:
 - "optimize github metadata"
 - "make repo more discoverable"
 
+### readme-enhance
+
+Enhances README with badges and infographics. Triggered by:
+- "enhance readme"
+- "add badges to readme"
+- "create readme infographic"
+- "improve readme marketing"
+- "add shields.io badges"
+- "generate project infographic"
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `/social-preview` | Generate a social preview image for the current project |
-| `/social-preview:setup` | Interactive setup wizard for configuration |
+| `/github-social:setup` | Interactive setup wizard for configuration |
 | `/repo-metadata` | Generate optimized description and topics (use `--apply` to update GitHub) |
+| `/readme-enhance` | Add marketing badges and infographic to README |
+| `/github-social:all` | Run all skills in sequence (metadata, social preview, README enhancement) |
 
 ## License
 

commands/all.md

@@ -0,0 +1,156 @@
+---
+name: all
+description: Run all github-social skills in sequence - metadata, social preview, and README enhancement
+argument-hint: "[--apply] [--dry-run] [--skip-badges] [--skip-infographic]"
+allowed-tools: ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "MCPSearch"]
+---
+
+# Complete GitHub Social Enhancement
+
+Run all github-social skills in sequence to fully optimize a repository's presentation:
+
+1. **repo-metadata**: Generate optimized description and topics
+2. **social-preview**: Generate social preview image
+3. **readme-enhance**: Add badges and infographic to README
+
+## Execution Steps
+
+### 1. Parse Arguments
+
+Handle optional flags:
+- `--apply`: Apply all changes (update GitHub metadata, modify README, upload images)
+- `--dry-run`: Preview all changes without applying any
+- `--skip-badges`: Skip badge generation in README enhancement
+- `--skip-infographic`: Skip infographic generation
+
+Default behavior: Generate and preview, prompt before applying.
+
+### 2. Load Configuration
+
+Read `.claude/github-social.local.md` for all skill settings:
+- Social preview provider and style
+- Badge style preferences
+- Infographic style preferences
+- Upload settings
+
+### 3. Analyze Project (Shared)
+
+Perform comprehensive project analysis once, reuse across all skills:
+
+1. Read README.md, package manifest, CLAUDE.md
+2. Extract from git remote: owner, repo name, default branch
+3. Identify:
+   - Project name and version
+   - Purpose and key features
+   - Primary language and frameworks
+   - CI/CD configuration
+   - License type
+   - Documentation sites
+   - Community links
+
+### 4. Execute Skills in Sequence
+
+#### Step 4a: Repository Metadata
+
+Generate optimized GitHub metadata:
+- Description (max 350 chars, engaging, SEO-friendly)
+- Topics (max 20, lowercase, hyphenated)
+
+Output preview of changes.
+
+#### Step 4b: Social Preview Image
+
+Generate social preview:
+- Create image prompt based on project analysis
+- If provider configured, generate actual image
+- Save to configured output path (default: `.github/social-preview.png`)
+
+Output the image prompt (and image location if generated).
+
+#### Step 4c: README Enhancement
+
+Unless `--skip-badges` and `--skip-infographic` both set:
+- Generate shields.io badges (unless `--skip-badges`)
+- Generate infographic prompt (unless `--skip-infographic`)
+- Prepare README.md updates
+
+Output badge set and infographic prompt.
+
+### 5. Present Summary
+
+Display complete summary:
+
+```
+## GitHub Social Enhancement Summary
+
+### Repository Metadata
+- Description: "..." (X chars)
+- Topics: topic-1, topic-2, topic-3, ...
+
+### Social Preview
+- Image prompt generated
+- Output: .github/social-preview.png
+- [Generated/Pending generation]
+
+### README Enhancement
+- Badges: X badges generated
+- Infographic: Prompt ready
+- README changes: [Preview/Applied]
+
+### Next Steps
+[Instructions based on --apply flag]
+```
+
+### 6. Apply Changes (if --apply or confirmed)
+
+If `--apply` flag or user confirms:
+
+1. **Update GitHub metadata** (via gh CLI):
+   ```bash
+   gh repo edit --description "..."
+   gh repo edit --add-topic topic-1 --add-topic topic-2 ...
+   ```
+
+2. **Generate and upload social preview** (if provider configured):
+   - Generate image via configured provider
+   - Upload to repository if `upload_to_repo: true`
+
+3. **Update README.md**:
+   - Insert/update badge section
+   - Add infographic placeholder/image
+
+4. **Report results**:
+   - Confirm each step completed
+   - Provide GitHub settings links for manual steps
+
+## Example Usage
+
+```bash
+# Preview all enhancements
+/github-social:all
+
+# Apply all changes automatically
+/github-social:all --apply
+
+# Dry run to see what would change
+/github-social:all --dry-run
+
+# Skip certain features
+/github-social:all --apply --skip-infographic
+/github-social:all --apply --skip-badges
+```
+
+## Tips
+
+- Run without `--apply` first to review changes
+- Ensure `gh` CLI is authenticated for metadata updates
+- Configure `.claude/github-social.local.md` for image generation
+- Social preview requires manual GitHub settings update after upload
+- Use `--dry-run` to safely preview all changes
+
+## Related Commands
+
+- `/social-preview` - Generate social preview image only
+- `/repo-metadata` - Generate metadata only
+- `/readme-enhance` - Enhance README only
+- `/github-social:setup` - Configure plugin settings