Skip to content
Back to skills

Kai Newsletter

ASecurity

Plan and produce newsletter editions — content selection, subject lines, scheduling, and production with quality gates. Use when "newsletter", "plan newsletter", "newsletter content", "email newsletter", "weekly digest", or any request to create or manage a newsletter.

  • 66 stars
  • 0 votes
  • 1 copy
  • 5 views
  • Added October 26, 2026
content-marketingpythongoapiperformance

Works with

  • cli
  • api

Security analysis

A100/100

Scanned October 26, 2026

npx -y skills add cgallic/kai-cmo-harness --skill kai-newsletter --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Kai Newsletter?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Kai Newsletter
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/cgallic-kai-newsletter-kai-cmo-harness/badge)](https://www.skillsdirectory.com/skills/cgallic-kai-newsletter-kai-cmo-harness)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: kai-newsletter
description: Plan and produce newsletter editions — content selection, subject lines, scheduling, and production with quality gates. Use when "newsletter", "plan newsletter", "newsletter content", "email newsletter", "weekly digest", or any request to create or manage a newsletter.
---

# Kai Newsletter Skill

Plan and produce newsletter editions with strategy, content selection, subject lines, and full production pipeline.

---

## Phase 0: Load Product Context

Check if `MARKETING.md` exists in the **project root** (same directory as CLAUDE.md, README.md, package.json).

**If it exists:** Read it — skip product discovery questions. It has the product name, ICP, value prop, monetization, brand voice, current channels, and competitive landscape.

**If it does NOT exist:** Auto-explore the codebase to create it in the **project root** (next to CLAUDE.md). Do NOT ask the user what the product is. Read CLAUDE.md, README.md, PROJECT.md, package.json, landing pages, and any project files. Search for email/ad/analytics config. Then create `MARKETING.md` using the template from `/kai-email-system`. Present draft to user for confirmation.

---

## Phase 1: Discovery

Read from `MARKETING.md`. Only ask about things not covered there:

1. **Newsletter purpose** — What is the goal? (nurture, educate, drive traffic, retain)
2. **Audience** — Which persona(s) from the harness? Load from `knowledge/personas/_persona-index.md`
3. **Cadence** — Weekly, biweekly, monthly?
4. **Existing content** — Any blog posts, articles, or assets to feature?
5. **Brand voice** — Formal, conversational, irreverent?
6. **Past performance** — Open rates, click rates, unsubscribe trends?

---

## Phase 2: Plan

Build the newsletter edition plan:

1. **Load strategy framework**: `knowledge/channels/newsletter-strategy.md`
2. **Load email lifecycle patterns**: `knowledge/channels/email-lifecycle.md`
3. **Load skill contract**: `harness/skill-contracts/email-lifecycle.yaml`
4. **Load growth economics** (only when the request involves list growth, acquisition budget, subscriber value, or list-quality diagnosis): `knowledge/playbooks/newsletter-growth-economics.md`
5. **Define edition structure**:
   - Hero story / lead piece
   - Supporting content (2-3 items)
   - Quick links / resource roundup
   - CTA (one primary, one secondary max)
6. **Subject line candidates** — Generate 5+ options, score for open-rate potential
7. **Preview text** — Complement (not repeat) the subject line
8. **Segment targeting** — Which list segment receives this edition?

---

## Phase 3: Produce

Write the newsletter content:

1. **Hero section** — Lead with the most valuable piece. Hook in the first line.
2. **Supporting sections** — Brief summaries with clear value. Link out to full content.
3. **Tone** — Match persona language patterns. No corporate filler.
4. **CTA** — One clear action per edition. Make it specific.
5. **Footer** — Manage expectations (next edition date, what to expect).

Apply these rules from the harness:
- Conditions AFTER main clause ("Do X if Y")
- Instructions start with verbs
- Sentences under 20 words where possible
- Bold the answer, not the query terms

---

## Phase 4: Quality Gates

Run all gates before delivery:

1. **Four U's Score**: `python scripts/quality_gates/four_us_score.py <file>`
   - Minimum: **10/16** (email threshold)
2. **Banned Word Check**: `python scripts/quality_gates/banned_word_check.py <file>`
   - Zero Tier 1 violations
3. **AI Slop Check** — No phrases like "In conclusion", "It's important to note", "In today's rapidly evolving"
4. **Subject line validation** — Under 50 characters, no spam trigger words, no ALL CAPS

Max 2 auto-retry cycles. After 2 failures, surface to human with specific failure reasons.

---

## Phase 5: Output

Deliver the final newsletter package:

- **Subject line** (final selection with rationale)
- **Preview text**
- **Full newsletter body** (HTML-ready or plain text as requested)
- **Send time recommendation** (based on audience segment)
- **Four U's scorecard**
- **Gate pass/fail summary**

Write output to `workspace/` with filename pattern: `newsletter-YYYY-MM-DD.md`

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in content-marketing →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.