Agent skill

optimize-newsletter

Optimize a newsletter draft or write a full issue from an outline. Use when asked to 'optimize this draft', 'polish this newsletter', 'write from this outline', 'improve this issue', or when transforming an existing draft or outline into a publication-ready issue. Distinct from plan-newsletter which starts from a topic — this starts from existing content.

Stars 124
Forks 35

Install this agent skill to your Project

npx add-skill https://github.com/kenneth-liao/ai-launchpad-marketplace/tree/main/creator-stack/skills/optimize-newsletter

SKILL.md

Optimize Newsletter Issue

Orchestrate foundation skills to transform outlines into full drafts or optimize rough drafts into high-performing newsletter issues. This is a thin orchestrator — it sequences skill invocations and manages the user review workflow, but delegates all content generation to foundation skills.

Core Principle: This is a thin orchestrator. All content generation goes through the appropriate foundation skill — that's how quality stays consistent and voice stays authentic. This skill manages workflow sequence and user decisions only.

When to Use

Use this skill when:

  • Transforming an outline into a full newsletter draft
  • Optimizing or polishing an existing rough draft
  • The user has newsletter content that needs quality improvement
  • Converting notes or bullet points into a publication-ready issue

Do NOT use this skill when:

  • Starting from a topic with no existing content (use creator-stack:plan-newsletter instead)
  • Creating visual assets for a newsletter (use creator-stack:newsletter-visuals)

Prerequisites

Existing content must be available. Either:

  1. A newsletter outline (bullet points, topic structure, notes), OR
  2. A rough draft that needs optimization

Newsletter Workflow

Execute all steps below in order.

Step 1: Assess the Input

Determine the input type and issue type:

  • Outline: Bullet points, topic structure, or notes → full draft workflow
  • Rough draft: Existing prose that needs optimization → audit and optimize workflow

Present the assessment to the user: input type, detected issue type, and the workflow that follows.

Step 2: Draft or Optimize Content

From outline:

  1. Invoke creator-stack:write with content type "newsletter" to write the full draft.
    • Pass the outline as source material
    • The writing skill loads its own references/newsletter.md for section rules, issue types, and writing conventions
  2. The draft follows the Newsletter Arc: Hook → Context → Value → Close

From rough draft:

  1. Invoke creator-stack:write with content type "newsletter" to audit and optimize each section.
    • Pass the draft as source material with instruction to optimize
    • The writing skill checks against its section rules and body writing rules
  2. Present findings: what works, what needs improvement, and specific recommendations
  3. Rewrite/optimize sections that fall short

Step 3: Generate Subject Lines

  1. Invoke creator-stack:title with content type "newsletter" to generate 3 subject line options.
    • Pass the draft content as context
    • The title skill loads its own references/newsletter-subject-lines.md for formulas and rules
  2. Each option includes preview text (subtitle)
  3. Document all options with star ratings and recommendation

Step 4: Generate Opening Hook

  1. Invoke creator-stack:hook with content type "newsletter" to generate 2-3 hook options.
    • Pass the selected subject line and draft content as context
    • The hook skill loads its own references/newsletter-hooks.md for hook patterns
  2. Each hook must extend curiosity from the subject line (not repeat it)
  3. Document all options with rationale

Step 5: Present Options and Get User Selection

  1. Present subject line options with star ratings
  2. Present hook options with rationale
  3. Present the full draft (or optimized draft)
  4. Ask the user to select subject line + hook

Always present all options — the user makes the final call, not the orchestrator.

Step 6: Run Pre-Publish Checklist

  1. Read references/pre-publish-checklist.md
  2. Run through every check against the final draft
  3. Flag any items that don't pass
  4. Present results to the user with specific fixes for any failures

Step 7: Finalize

  1. Assemble the final issue: selected subject line + preview text + selected hook + optimized body + close + P.S.
  2. Present the complete, publication-ready issue to the user

Output Structure

Present the final issue in this structure:

markdown
# [Subject Line]
*[Preview Text]*

[Opening Hook]

[Body Content - sections with subheadings]

[Close]

P.S. [Secondary CTA or personal touch]

Delegation Reference

Each foundation skill owns its own reference files. When you invoke a skill, it loads the right references automatically — you don't need to manage file paths.

Content Skill Why
Newsletter prose (draft + optimize) creator-stack:write Owns section rules, body writing conventions, voice invocation
Subject lines creator-stack:title Owns subject line formulas and open rate patterns
Opening hooks creator-stack:hook Owns hook patterns and curiosity extension logic
Voice consistency creator-stack:voice Invoked automatically by writing skill — no manual call needed

Quality Checklist

  • Input type assessed (outline vs. draft)
  • creator-stack:write invoked for content generation/optimization
  • creator-stack:title invoked for subject lines (3 options generated)
  • creator-stack:hook invoked for opening hooks (2-3 options generated)
  • All options presented with star ratings
  • User selected subject line and hook
  • Pre-publish checklist run (all items pass or flagged)
  • Final issue assembled and presented

Common Pitfalls

  1. Writing content manually: Generating newsletter prose instead of delegating to creator-stack:write — the foundation skill has all the section rules and voice handling built in.
  2. Single option: Presenting one subject line or hook instead of multiple options — users need choices to make good decisions.
  3. Skipping the pre-publish checklist: The checklist catches issues the draft workflow misses.
  4. Fat orchestrator: Adding writing techniques, section rules, or formatting guidance here instead of keeping them in foundation skill references — that logic belongs in the skill that owns it.

Expand your agent's capabilities with these related and highly-rated skills.

kenneth-liao/ai-launchpad-marketplace

test-skill

Run or generate test suites for any skill. Use when testing a skill before deployment, after making changes, before/after plugin upgrades, when validating skill behavior, or when the user says "test skill", "run skill tests", "generate tests for skill", or "check for regressions".

124 35
Explore
kenneth-liao/ai-launchpad-marketplace

upgrade-plugin

Upgrade a plugin's skills, hooks, and patterns to align with latest Claude Code capabilities and best practices. Use when a plugin needs modernization, after Claude Code updates, or when the user says "upgrade plugin", "modernize plugin", or "update plugin to latest patterns".

124 35
Explore
kenneth-liao/ai-launchpad-marketplace

skill-retro

Use when reviewing how skills performed during a session, when the user wants to analyze skill invocations and identify improvements, or when the user says "skill retro", "review skills", "how did skills do", "improve this skill", or "skill retrospective".

124 35
Explore
kenneth-liao/ai-launchpad-marketplace

view-team-session

Generate a self-contained HTML viewer for any Claude Code session, including agent team sessions with full inter-agent DM timelines. Use whenever the user asks to "view a session", "visualize a conversation", "show me what happened in session X", "generate a session viewer", "replay a session", "show me what my agents did", "session replay", "team timeline", or references viewing/inspecting Claude Code JSONL logs. Also use when the user provides a session ID and wants to see the conversation.

124 35
Explore
kenneth-liao/ai-launchpad-marketplace

analyze-team-session

Use when reviewing an agent team session export for quality, when asked to "analyze this team session", "review my agent team run", "what went wrong with this session", "how can I improve my agent team usage", or when provided a markdown team session transcript and asked for feedback on agent teams effectiveness.

124 35
Explore
kenneth-liao/ai-launchpad-marketplace

youtube-data

Retrieve YouTube data using the YouTube Data API. Use when you need to search videos, get video or channel details, fetch transcripts, read comments, find trending or related content, or when the user mentions 'YouTube data', 'video stats', 'transcript', or 'channel info'.

124 35
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results