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#

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-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#

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.

PathPurposeWhen to readreferences/pipeline.mdFull step-by-step executionWhen running the writing pipelinereferences/platform-dna.mdGhost audience, newsletter metrics, format constraintsBefore any content workreferences/content-generation-playbook.mdIdea → Ghost-native draft workflowWhen generating new contentreferences/content-adaptation-playbook.mdExisting article → Ghost-native workflowWhen adapting/cross-posting contentreferences/content-adaptation.mdGhost writing rules, structure, tone (legacy)Supplementary referencereferences/api-reference.mdYouMind Ghost OpenAPI endpoint documentationWhen calling Ghost through YouMind~/.youmind/config.yamlShared API credentials (YouMind only)Step 1output/**Local article Markdown drafts (git-ignored)**When writing the articletoolkit/dist/*.jsExecutable scripts (run from toolkit/)Various steps

Draft Location Rule#

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

User's inputOperationPlaybook to loadIdea, topic, or thesis onlyGeneratereferences/content-generation-playbook.mdExisting article from blog/other platformCross-postreferences/content-adaptation-playbook.mdArticle in another languageTranslatereferences/content-adaptation-playbook.md (translate mode)Same-language article needing Ghost editorial register shiftLocalizereferences/content-adaptation-playbook.md (localize mode)Long article → newsletter versionCondensereferences/content-adaptation-playbook.md (condense mode)Old Ghost post to updateRevivereferences/content-adaptation-playbook.md (revive mode)Section → bookmark card contentExcerptreferences/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. 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.

StepActionKey reference1Load config and validate the YouMind API key, paid-plan access, and Ghost connection in YouMind--2Mine YouMind knowledge base for source material--3Research topic via web search--4Adapt content for Ghost audience and HTML renderingreferences/content-adaptation.md5Write article in Markdown--6Publish to Ghost via YouMind Ghost OpenAPIreferences/api-reference.md7Report results: post ID, status, public URL, Ghost Admin URL, result links--

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.

StepFallback2 Knowledge miningSkip, empty knowledge context3 ResearchAsk user for manual input6 PublishingGenerate local HTML preview7 ArchivingWarn, continue

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