AI Ghost Article Writer

Write professional Ghost articles with AI. Topic research via YouMind knowledge base, Ghost-oriented writing, Markdown-to-HTML conversion, feature image upload, and one-click publishing to Ghost through the user's Ghost 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 Ghost Article Writer installed!

Tell me your topic and I'll write and publish a Ghost article for you.

Try it now: "Write a Ghost article about AI programming trends"

What it does:

• Research topics from YouMind knowledge base and the web
• Write clean Ghost-style articles in Markdown
• Convert Markdown to HTML optimized for Ghost
• Upload feature images
• Publish directly to Ghost as draft or public through the Ghost 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-ghost-article.yaml.
4. Connect your Ghost account inside YouMind before publishing. This skill no longer reads ghost.admin_api_key or ghost.site_url locally.

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

Need help? Just ask!

Usage

Provide a topic, a raw Markdown file, or describe the Ghost article you want.

Write from a topic:

Write a Ghost article about the workflow changes AI coding agents introduced

Publish existing Markdown:

Publish this markdown to Ghost as a draft

Manage existing posts:

List my Ghost drafts Publish Ghost post 69de04770c17b300017b5650 Move Ghost post 69de04770c17b300017b5650 back to draft

Setup

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

Step 1 -- Install Dependencies

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

Step 2 -- Create Config File

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-ghost-article.yaml.

Step 3 -- Get YouMind API Key

YouMind API Key enables knowledge base search, web search, article archiving, and Ghost publishing.

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-ghost-article.yaml.

Step 4 -- Connect Ghost in YouMind

1. Open YouMind and connect your Ghost account in the product's publishing / connector settings flow
2. Save the Ghost site URL and Admin API key there once
3. Keep only youmind.api_key in ~/.youmind/config.yaml

Verify Setup

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.

Draft Location Rule

Canonical: write local article Markdown files to ~/.youmind/articles/ghost/\x3Cslug>.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-ghost-article/output/\x3Cslug>.md.

• Correct: ~/.youmind/articles/ghost/my-article.md
• Correct (legacy): skills/youmind-ghost-article/output/my-article.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/ghost). Kebab-case filenames (my-article.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 Ghost article 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 (custom excerpt + email-safe HTML discipline stay native to this skill). Without such a brief, the skill runs its own pipeline normally.
• 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 Ghost's real product surfaces: newsletters, members visibility, custom excerpts, feature images, editor cards, email-safe HTML, and audience segmentation.

Intent routing

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. Newsletter readiness: Custom excerpt + email-safe HTML + CTA verified
4. User approval: Do not auto-publish without confirmation

Result Links Rule

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

• Prefer the public URL for live posts.
• Include the Ghost Admin URL for draft/scheduled review and management.
• If no exact results page exists, return the best Ghost admin entry URL instead.
• Never leave the user with only a post ID or slug.

Pipeline Overview

Read references/pipeline.md for full execution details.

Routing shortcuts:

• User gave a specific topic -> Skip broad research, go to Step 4
• User gave raw Markdown -> Skip to Step 6 (publish)
• User wants preview only -> Run local conversion, skip publishing

Critical Quality Rules

Non-negotiable for every Ghost article:

1. Write for real readers, not SEO sludge. Ghost audiences expect an editorial tone.
2. Keep paragraphs short. The same content may be read on web and in email newsletters.
3. Use meaningful section headings. Ghost posts need strong structure.
4. Custom excerpt matters. It drives cards, previews, and newsletter subject/context.
5. Tags should be intentional. The first tag becomes primary routing context.
6. Avoid raw Markdown assumptions. Ghost publishing goes through HTML conversion, so check code blocks and embeds carefully.
7. Default to draft. Do not surprise the user by publishing publicly unless asked.

Resilience: Never Stop on a Single-Step Failure

Every step has a fallback. If a step AND its fallback both fail, skip and note it in the final output.

References

• YouMind Ghost OpenAPI: see references/api-reference.md
• Content rules: see references/content-adaptation.md
• Pipeline: see references/pipeline.md
• YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-ghost-article