# Promote

Generate X/Twitter release promotion posts with ASCII tables and CodeSnap rendering.

- Repository: https://github.com/oliver-kriska/claude-elixir-phoenix (572 stars)
- Category: Marketing
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add oliver-kriska/claude-elixir-phoenix --skill promote -g -a claude-code -y`
Codex: `npx skills add oliver-kriska/claude-elixir-phoenix --skill promote -g -a codex -y`
Cursor: `npx skills add oliver-kriska/claude-elixir-phoenix --skill promote -g -a cursor -y`
Gemini CLI: `npx skills add oliver-kriska/claude-elixir-phoenix --skill promote -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add oliver-kriska/claude-elixir-phoenix`

## Description

Generate X/Twitter release promotion posts with ASCII tables and CodeSnap rendering. Use when writing release posts, promotion tweets, plugin announcements, or preparing social media content for new versions.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# /promote, Release Promotion Post Generator

Generate data-driven X/Twitter posts for plugin releases with ASCII cards ready for CodeSnap screenshots.

## When to use

Run `/promote vX.Y.Z` after tagging a release. Optionally add a title: `/promote v2.8.0 "LiveView Streams Overhaul"`.

## Output

All files go to `scratchpad/x-posts/{version}-release.md` (create directory if needed).

The output file contains three sections:
1. **ASCII Card**, box-drawing table for CodeSnap screenshot
2. **Tweet Thread**, 3-5 tweets in proven format
3. **CodeSnap Command**, exact CLI command to render the card
4. **Fact-Check**, every claim with verifiable data source

## Execution Flow

### Step 1: Gather Data

Collect these metrics (all are verifiable commands, run them, don't estimate):

| Metric | How to get it |
|--------|---------------|
| File count + insertions/deletions | `git diff --stat {prev-tag}..{tag}` |
| Skill count | `ls plugins/elixir-phoenix/skills/ \| wc -l` |
| Agent count | `ls plugins/elixir-phoenix/agents/*.md \| wc -l` |
| Iron Law count | Grep for numbered Iron Laws in CLAUDE.md |
| Eval scores | `make eval-all` (run it, report actual numbers) |
| Changelog entries | Read CHANGELOG.md for this version's section |
| Before/after metrics | Depends on release, look for quantifiable changes |

The strongest posts have **before/after comparisons**. Look for changes in CHANGELOG.md that have measurable deltas (line counts, counts of affected files, error rates, coverage numbers).

### Step 2: Write the ASCII Card

The card is the visual centerpiece, it gets screenshotted via CodeSnap and attached to tweet 1.

The rest: https://github.com/oliver-kriska/claude-elixir-phoenix/blob/HEAD/.claude/skills/promote/SKILL.md