Write publication-native Beehiiv posts with AI. Topic research via YouMind knowledge base, Beehiiv-native post writing, Markdown-to-HTML conversion, and one-click publishing through the user's Beehiiv account already connected in YouMind.
> Get YouMind API Key | More Skills
MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Translate to the user's language:
> AI Beehiiv Post Writer installed!
>
> Tell me your topic and I'll write and publish a Beehiiv post for you.
>
> Try it now: "Write a Beehiiv post about how AI coding agents changed weekly product updates"
>
> What it does:
> - Research topics from YouMind knowledge base and the web
> - Write Beehiiv-native posts for the platform's email + web surfaces
> - Convert Markdown to HTML optimized for Beehiiv
> - Discover reusable post templates
> - Publish directly to Beehiiv through the Beehiiv 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-beehiiv-article.yaml.
> 4. Connect your Beehiiv account inside YouMind before publishing. This skill no longer reads local Beehiiv API keys.
>
> Important:
> - Beehiiv createPost can return 403 if the publication does not have the required Send API access.
> - Beehiiv officially marks update post as beta / Enterprise; do not promise it will be available everywhere.
> - If the user wants a recurring layout, inspect listPostTemplates first and use postTemplateId.
>
> No Beehiiv connection yet? You can still write and preview locally — just skip the publish step.
Provide a topic, a raw Markdown file, or describe the Beehiiv post you want.
Write from a topic:
> Write a Beehiiv post about the operator lessons we learned after moving to AI-assisted engineering
Publish existing Markdown:
> Publish this markdown to Beehiiv as a draft
Manage existing posts:
> List my Beehiiv post templates
> List my Beehiiv drafts
> Publish this Beehiiv post immediately
> Prerequisites: Node.js >= 18, a YouMind API key, and a Beehiiv account connected in YouMind if you want to publish.
cd toolkit && npm install && npm run build && cd ..
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-beehiiv-article.yaml.
sk-ym-xxxx key~/.youmind/config.yaml under youmind.api_keyyoumind.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-beehiiv-article.yaml.youmind.api_key in ~/.youmind/config.yamlcd 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.
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 Beehiiv pipeline |
references/platform-dna.md | Beehiiv publication, email/web, segmentation, and template norms | Before any content work |
references/content-generation-playbook.md | Idea → Beehiiv-native draft workflow | When generating new content |
references/content-adaptation-playbook.md | Existing article → Beehiiv-native workflow | When adapting/cross-posting content |
references/content-adaptation.md | Supplemental Beehiiv writing rules | Supplementary reference |
references/api-reference.md | YouMind Beehiiv OpenAPI endpoint documentation | When calling Beehiiv through YouMind |
~/.youmind/config.yaml | Shared API credentials (YouMind only) | Step 1 |
output/ | Local article Markdown drafts (git-ignored) | When writing the post |
toolkit/dist/*.js | Executable scripts (run from toolkit/) | Various steps |
Canonical: write local article Markdown files to ~/.youmind/articles/beehiiv/. This shared home directory is available to all YouMind skills — see shared/YOUMIND_HOME.md.
Legacy fallback (if ~/.youmind/ is not writable): skills/youmind-beehiiv-article/output/.
~/.youmind/articles/beehiiv/my-post.mdskills/youmind-beehiiv-article/output/my-post.mdreferences/, toolkit/, or an ad-hoc drafts/ directoryBoth locations are git-ignored. Create directories on demand (mkdir -p ~/.youmind/articles/beehiiv). Kebab-case filenames (my-post.md), descriptive slugs over timestamps.
This skill is self-contained and fully usable standalone. The youmind-article-dispatch hub is an optional companion; it is NOT required for anything.
~/.youmind/author-profile.yaml (shared home directory — see shared/YOUMIND_HOME.md) for cross-platform voice preferences. Works whether or not dispatch is installed.resolved_author, the skill uses those fields as extra context, but still applies Beehiiv-native rules like email/web dual-surface fit, segmentation, and template-aware structure.dispatch-capabilities.yaml is metadata that lets dispatch route intelligently. Deleting it reverts to defaults; it never breaks this skill.shared/DISPATCH_CONTRACT.md (v1.0).Before writing any content, read references/platform-dna.md to internalize Beehiiv's actual post model: one post can serve email, web, segments, free/premium access, and reusable templates.
| 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 → Beehiiv post version | Condense | references/content-adaptation-playbook.md (condense mode) |
| Old Beehiiv post to refresh | Revive | references/content-adaptation-playbook.md (revive mode) |
| Section → short launch/update post | Excerpt | references/content-adaptation-playbook.md (excerpt mode) |
After any draft, scheduled, or published Beehiiv action, always end with Result links.
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 Beehiiv connection in YouMind | -- |
| 2 | Mine YouMind knowledge base for source material | -- |
| 3 | Research topic via web search | -- |
| 4 | Inspect Beehiiv post templates / audience needs when relevant | references/api-reference.md |
| 5 | Adapt content for Beehiiv's email + web + segmentation surfaces | references/content-adaptation.md |
| 6 | Write article in Markdown | -- |
| 7 | Publish to Beehiiv via YouMind Beehiiv OpenAPI | references/api-reference.md |
| 8 | Report results: post ID, status, public URL if available, and send/template caveats | -- |
Routing shortcuts:
List my Beehiiv post templates → inspect reusable layout options before writingPublish immediately → confirmed flow, but warn about Send API access if certainty mattersKeep it as draft → safest default共 1 个版本