| name | leather-changelog |
| description | Generate product changelog entries, X/Twitter posts, and Slack announcements for Leather wallet releases. Use when creating release communications including changelog entries for app.leather.io/changelog, announcement tweets (single or threads), and community Slack posts. Inputs may include verbal feature descriptions, Linear projects, or GitHub PRs. |
Leather Release Communications
Generate consistent, on-brand release communications for Leather wallet across changelog entries, X posts, and Slack announcements.
Process
- Gather context — Review provided feature description, Linear project, or GitHub PRs
- Identify the "why" — Determine the user problem being solved or improvement being delivered
- Read format references — See
references/voice-and-formats.md for voice guidelines and templates
- Generate outputs — Create requested formats (changelog, X post, Slack, or all three)
Output Summary
| Format | Purpose | Length |
|---|
| Changelog | Permanent product record at app.leather.io/changelog | 50-150 words |
| X single | Quick announcement for smaller features | 280 chars max |
| X thread | Major releases needing context | 3-5 tweets |
| Slack | Community announcement | 100-200 words |
Voice Principles
- Lead with impact — Start with why this matters to users, not what changed technically
- Understated confidence — Let the product speak; avoid hype words ("excited", "thrilled", "game-changing")
- One idea per sentence — Short, declarative statements
- Show don't tell — Concrete benefits over abstract claims
See references/voice-and-formats.md for detailed guidelines and examples.
Sanity CMS Integration
Use scripts/sanity-changelog.js to upload changelog entries to Sanity CMS as drafts.
Setup
export SANITY_PROJECT_ID="your-project-id"
export SANITY_DATASET="production"
export SANITY_API_TOKEN="your-write-token"
Usage
node scripts/sanity-changelog.js --title "Feature title" --body changelog.md --dry-run
node scripts/sanity-changelog.js --title "Feature title" --body changelog.md
node scripts/sanity-changelog.js \
--title "Feature title" \
--body changelog.md \
--slug "custom-slug" \
--published-at "2025-01-15T10:00:00Z"
Markdown Support
The script converts markdown to Sanity Portable Text:
- Paragraphs (separated by blank lines)
## Headings and ### Headings → h2 blocks**bold**, *italic*, `code` inline formatting
Options
| Option | Description |
|---|
--title, -t | Changelog entry title (required) |
--body, -b | Path to markdown file (required) |
--slug, -s | URL slug (auto-generated if not provided) |
--published-at | ISO datetime (default: now) |
--hero-image | Sanity asset ID for hero image |
--dry-run | Test without creating document |
