youmind-kit-article

Write and publish Kit broadcasts with AI — topic research via YouMind knowledge base, creator-profile-aware broadcast writing, Markdown-to-HTML conversion, and publishing through the Kit account already connected in YouMind. Use when user wants to "write Kit article", "publish to Kit", "Kit broadcast", "ConvertKit article", "写 Kit 文章", "发布到 Kit".

AI Kit Broadcast Writer

Write creator-native Kit broadcasts with AI. Topic research via YouMind knowledge base, Kit-native broadcast writing, Markdown-to-HTML conversion, and one-click publishing through the user's Kit account already connected in YouMind.

Get YouMind API Key | More Skills

Onboarding

MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Translate to the user's language:

AI Kit Broadcast Writer installed!

Tell me your topic and I'll write and publish a Kit broadcast for you.

Try it now: "Write a Kit broadcast about what changed in our AI workflow this week"

What it does:

• Research topics from YouMind knowledge base and the web
• Write creator-style broadcasts for Kit's inbox + public feed surfaces
• Convert Markdown to HTML optimized for Kit
• Discover usable email templates
• Publish directly to Kit as public or private through the Kit account connected in YouMind

Setup (one-time):

1. Install & configure: cd toolkit && npm install && npm run build && cd .. && mkdir -p ~/.youmind/config && cp shared/config.example.yaml ~/.youmind/config.yaml
2. Get YouMind API Key and fill youmind.api_key in ~/.youmind/config.yaml
3. Keep youmind.base_url pointed at https://youmind.com/openapi/v1 in docs. If you need local backend debugging, change ~/.youmind/config.yaml or ~/.youmind/config/youmind-kit-article.yaml.
4. Connect your Kit account inside YouMind before publishing. This skill no longer reads local Kit API keys.

Important:

• Kit sender email must already be confirmed, otherwise broadcast creation can fail.
• Private broadcasts are best checked in https://app.kit.com/campaigns.
• Public web URLs are not guaranteed to come back from the API; if missing, check the Broadcast report page and click Open.

No Kit connection yet? You can still write and preview locally — just skip the publish step.

Usage

Provide a topic, a raw Markdown file, or describe the Kit broadcast you want.

Write from a topic:

Write a Kit broadcast about the three workflow changes AI coding agents forced on our team

Publish existing Markdown:

Publish this markdown to Kit as a public broadcast

Manage existing broadcasts:

List my Kit broadcasts List my Kit email templates Publish this as a private Kit draft

Setup

Prerequisites: Node.js >= 18, a YouMind API key, and a Kit account connected in YouMind if you want to publish.

Step 1 -- Install Dependencies

bash

cd toolkit && npm install && npm run build && cd ..

Step 2 -- Create Config File

bash

mkdir -p ~/.youmind/config
cp shared/config.example.yaml ~/.youmind/config.yaml

Canonical credentials: put your shared YouMind credentials in ~/.youmind/config.yaml — filled ONCE and read by every YouMind skill. See shared/config.example.yaml for the template and shared/YOUMIND_HOME.md. Optional skill overrides live in ~/.youmind/config/youmind-kit-article.yaml.

Step 3 -- Get YouMind API Key

1. Open YouMind API Keys
2. Click Create API Key
3. Copy the sk-ym-xxxx key
4. Fill in ~/.youmind/config.yaml under youmind.api_key
5. Keep youmind.base_url as https://youmind.com/openapi/v1 in examples and documentation. Local backend testing should only override ~/.youmind/config.yaml or ~/.youmind/config/youmind-kit-article.yaml.

Step 4 -- Connect Kit in YouMind

1. Open YouMind and connect your Kit account in the product's publishing / connector settings flow
2. Save the Kit API key there once
3. Confirm the sender email inside Kit before trying to create broadcasts
4. Keep only youmind.api_key in ~/.youmind/config.yaml

Verify Setup

bash

cd toolkit && npx tsx src/cli.ts validate

If the account is not connected, the OpenAPI returns a connector URL pointing to https://youmind.com/settings/connector.

If the current plan is not eligible, the OpenAPI returns 402 and points the user to https://youmind.com/pricing.

Skill Directory

This skill is a folder. Read files on demand -- do NOT load everything upfront.

Path	Purpose	When to read
references/pipeline.md	Full step-by-step execution	When running the broadcast pipeline
references/platform-dna.md	Kit creator-profile, newsletter-feed, and broadcast norms	Before any content work
references/content-generation-playbook.md	Idea → Kit-native broadcast workflow	When generating new content
references/content-adaptation-playbook.md	Existing article → Kit-native workflow	When adapting/cross-posting content
references/content-adaptation.md	Supplemental Kit writing rules	Supplementary reference
references/api-reference.md	YouMind Kit OpenAPI endpoint documentation	When calling Kit through YouMind
~/.youmind/config.yaml	Shared API credentials (YouMind only)	Step 1
output/	Local article Markdown drafts (git-ignored)	When writing the broadcast
toolkit/dist/*.js	Executable scripts (run from toolkit/)	Various steps

Draft Location Rule

Canonical: write local article Markdown files to ~/.youmind/articles/kit/<slug>.md. This shared home directory is available to all YouMind skills — see shared/YOUMIND_HOME.md.

Legacy fallback (if ~/.youmind/ is not writable): skills/youmind-kit-article/output/<slug>.md.

• Correct: ~/.youmind/articles/kit/my-broadcast.md
• Correct (legacy): skills/youmind-kit-article/output/my-broadcast.md
• Wrong: skill root directly, references/, toolkit/, or an ad-hoc drafts/ directory

Both locations are git-ignored. Create directories on demand (mkdir -p ~/.youmind/articles/kit). Kebab-case filenames (my-broadcast.md), descriptive slugs over timestamps.

Dispatch Integration (Optional)

This skill is self-contained and fully usable standalone. The youmind-article-dispatch hub is an optional companion; it is NOT required for anything.

• Primary mode — standalone: Invoke directly ("Write a Kit broadcast about X"). Works with zero other YouMind skills installed.
• Author voice lookup: This skill reads ~/.youmind/author-profile.yaml (shared home directory — see shared/YOUMIND_HOME.md) for cross-platform voice preferences. Works whether or not dispatch is installed.
• Optional dispatch-mode invocation: When dispatch invokes this skill with a content brief containing resolved_author, the skill uses those fields as extra context, but still applies Kit-native requirements like subject/preview alignment, creator-profile fit, and campaigns/public-feed behavior.
• Capability manifest (opt-in): dispatch-capabilities.yaml is metadata that lets dispatch route intelligently. Deleting it reverts to defaults; it never breaks this skill.
• Optional interop protocol: shared/DISPATCH_CONTRACT.md (v1.0).

Content Modes

Before writing any content, read references/platform-dna.md to internalize Kit's actual product surfaces: broadcasts, creator profile newsletter feed, and creator-network discoverability.

Intent routing

User's input	Operation	Playbook to load
Idea, topic, or thesis only	Generate	references/content-generation-playbook.md
Existing article from blog/other platform	Cross-post	references/content-adaptation-playbook.md
Long article → broadcast version	Condense	references/content-adaptation-playbook.md (condense mode)
Old broadcast to refresh	Revive	references/content-adaptation-playbook.md (revive mode)
Section → short public-post teaser	Excerpt	references/content-adaptation-playbook.md (excerpt mode)

Quality gates (before publish)

1. Self-critique: Pass all checklist items in the playbook's Step 6
2. Conformance report: Generate and present to user (Step 7/8)
3. Kit fit: Subject + preview + first screen + CTA are aligned
4. User approval: Do not auto-publish without confirmation

Result Links Rule

After any draft, scheduled, or published Kit action, always end with Result links.

• Prefer the public post URL when it exists.
• Include the best Kit management entry point when the post is private or the API did not return a stable public URL.
• Private broadcasts should explicitly point the user to https://app.kit.com/campaigns.
• If the user needs the exact public URL and the API response omitted it, tell them to open the Broadcast report in Kit and click Open.
• Never leave the user with only a broadcast ID.

Pipeline Overview

Read references/pipeline.md for full execution details.

Step	Action	Key reference
1	Load config and validate the YouMind API key, paid-plan access, and Kit connection in YouMind	--
2	Mine YouMind knowledge base for source material	--
3	Research topic via web search	--
4	If needed, inspect Kit email templates and decide public/private mode	references/api-reference.md
5	Adapt content for Kit's inbox + public-feed surfaces	references/content-adaptation.md
6	Write article in Markdown	--
7	Publish to Kit via YouMind Kit OpenAPI	references/api-reference.md
8	Report results: broadcast ID, visibility, public URL if available, and fallback links	--

Routing shortcuts:

• List my Kit email templates → inspect templates before writing
• Make it private → private broadcast + campaigns fallback
• Make it public → public creator-profile/newsletter-feed post