---
name: diff-marketing
description: Generate customer-focused marketing content from recent git changes, commits, merged pull requests, and shipped features. Use when the user invokes /diff-marketing or /marketing, or asks for blog posts, tweets, changelogs, or emails about what shipped.
metadata:
  version: 1.0.0
  author: illyism
  source: https://il.ly/skills/diff-marketing
title: diff-marketing
canonical_url: https://skilld.dev/gh/illyism/seo-skills/diff-marketing
last_updated: 2026-10-14T13:01:44.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> If the user asked to install this Skill, run `npx skilld install illyism/seo-skills/diff-marketing`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/diff-marketing`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/illyism/seo-skills/diff-marketing) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/diff-marketing`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/diff-marketing --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/diff-marketing --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Diff marketing

Generate content suggestions from recent code changes, commits, merged pull requests, and shipped features.

## Process

1. Analyze recent changes:
   - Look at the git log for the past week:
     `git log --since="1 week ago" --pretty=format:"%h - %s (%an, %ar)"`
   - Check merged pull requests and their descriptions.
   - Review modified files and their purpose.
   - Identify new features, bug fixes, improvements, and refactors.

2. Categorize changes by impact:
   - High impact: new features, major improvements, breaking changes.
   - Medium impact: enhancements, notable bug fixes, performance improvements.
   - Low impact: minor fixes, refactors, dependency updates.

3. Read relevant files to understand the user-facing change before writing.

4. Generate specific content suggestions with drafts, prioritizing user value,
   SEO opportunities, and useful distribution channels.

## Content suggestions by type

### Blog posts

For high-impact changes:

- Focus on features that solve user problems.
- Include the problem, solution, benefits, screenshots or demos, and code examples when useful.
- Use an educational, in-depth, SEO-optimized angle.
- Aim for 800–2,000 words.
- Possible angles:
  - "Introducing [Feature]: How We Built..."
  - "How [Feature] Helps You..."
  - "Behind the Scenes: Building [Feature]"

### Tweets and social media

Use all impact levels for:

- Launch posts that explain the benefit and include a visual.
- Threads that break down complex features.
- Tip posts with a quick, useful takeaway.
- Behind-the-scenes posts about decisions and tradeoffs.

Keep the tone conversational, concise, and specific. Include emojis,
hashtags, mentions, links, and visuals when they add value. Treat a meaningful
release as a launch opportunity and suggest a way to gather early feedback.

### Changelog updates

- Structure entries as `## [Version] - [Date]`.
- Use Added, Changed, Fixed, Deprecated, Removed, and Security categories as applicable.
- Write in user-facing language.
- Link to documentation or blog posts for major features.
- Keep the writing technical but accessible.

### Email updates

For medium- and high-impact changes, suggest newsletters, feature
announcements, or onboarding updates.

- Include a hero image, brief introduction, feature highlights, and CTA when appropriate.
- Use a personal, benefit-focused, actionable tone.

### Press releases

Suggest these only for major launches, milestones, partnerships, or funding.
Include a headline, summary, quotes, boilerplate, and contact details. Use a
professional, newsworthy, quotable tone.

### Documentation

Suggest updates to:

- Getting-started guides.
- Feature documentation.
- API references.
- Code examples and use cases.
- Troubleshooting sections.

### Video content

For high-impact changes, suggest demos, tutorial walkthroughs, release
overviews, or development diaries.

## Content strategy

1. Repurpose a blog post into a thread, newsletter, and documentation update.
2. Coordinate content with the release.
3. Lead with user benefits.
4. Show the product with screenshots, GIFs, or videos.
5. Include keywords, meta descriptions, and alt text where relevant.
6. Give every piece a clear next step.
7. Cross-link related content.
8. Suggest how to collect feedback and measure response.

## Output format

Use this structure:

```markdown
## Week of [Date Range]

### Summary

[High-level overview of what shipped]

### High impact changes

- [Change 1]: [Description]
- [Change 2]: [Description]

### Medium impact changes

- [Change]: [Description]

### Low impact changes

- [Change]: [Description]

### Content suggestions

#### Blog posts

1. **"[Title]"**: [Brief description, key points, and target audience]
2. **"[Title]"**: [Brief description, key points, and target audience]

#### Tweets and threads

1. Launch post: [Draft text with emojis when appropriate]
2. Thread idea: [Topic and key points]
3. Tip: [Quick value post]

#### Changelog entry

## [Version] - [Date]

### Added

- [Feature]: [User-facing description]

### Fixed

- [Bug]: [What was fixed]

#### Email subject lines

- "[Compelling subject line option 1]"
- "[Compelling subject line option 2]"

#### Video ideas

- "[Video concept and key points to cover]"

#### Documentation updates needed

- [ ] Update [doc page] with [new information]
- [ ] Add [new guide] for [feature]
```

## Writing standards

- Use customer-centric messaging.
- Say what shipped and what it does. Do not invent metrics, customer results, or product behavior.
- Use diff output and relevant source files to ground every claim.
- Prefer plain language over hype.
- Avoid generic launch copy, unsupported superlatives, and vague claims.
- Use sentence-case headings and varied, natural prose.
- Keep emojis functional and sparse.
- End with the most useful next action for the reader.
