AI Tumblr Publisher#

Tumblr 不是“再发一份博客备份”。这个 skill 要做的是：把内容变成 Tumblr 会吃的形态，再通过 YouMind OpenAPI 发出去，并且能继续读 notes / notifications / followers / limits 做下一轮分发判断。

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 Tumblr Publisher installed!

Tell me your topic, draft, or image idea and I’ll turn it into a Tumblr-native post.

Try it now: "Write a Tumblr post about the hidden cost of maintaining AI agents"

What it does:

• Mine ideas from your YouMind knowledge base and shape them for Tumblr
• Write Tumblr-native text posts with stronger feed openings and clearer POV
• Publish image-led Tumblr photo posts from public image URLs
• Read notes, activity notifications, follower snapshots, and account limits
• Reorder or shuffle the Tumblr queue when you want to tune publishing rhythm

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. Connect your Tumblr account inside YouMind via the Connector Settings Tumblr OAuth flow
4. If you need local backend debugging, only override ~/.youmind/config.yaml or ~/.youmind/config/youmind-tumblr-article.yaml

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

Usage#

Provide a topic, Markdown draft, image URL, or an existing Tumblr post ID.

• Write a Tumblr post about why product teams overestimate AI automation
• Publish this Markdown draft to Tumblr
• Publish this image as a Tumblr photo post with a short caption
• Show me the notes on this Tumblr post
• Check my Tumblr activity notifications
• Move this queued Tumblr post to the top

Setup#

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

bash

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. Optional skill overrides live in ~/.youmind/config/youmind-tumblr-article.yaml. See shared/YOUMIND_HOME.md.

Get the API key from YouMind API Keys, connect Tumblr in Connector Settings, then verify:

bash

cd toolkit && node dist/cli.js validate

Skill Directory#

Read files on demand. Do not load everything up front.

PathPurposeWhen to readreferences/platform-dna.mdTumblr surfaces, reblog/notes logic, visual-fit decisionsBefore any content workreferences/pipeline.mdEnd-to-end execution lanesBefore running the workflowreferences/content-generation-playbook.mdTopic → Tumblr-native text/photo postWhen generating from an ideareferences/content-adaptation-playbook.mdExisting article/image → Tumblr-native versionWhen adapting or cross-postingreferences/media-playbook.mdWhen to use photo post vs text post with lead imageBefore image-led publishingreferences/engagement-playbook.mdNotes / notifications / followers / limits reviewWhen reading feedbackreferences/api-reference.mdYouMind Tumblr OpenAPI + CLI contractWhen calling Tumblr through YouMind

Draft Location Rule#

Canonical: write local adapted drafts to ~/.youmind/articles/tumblr/<slug>.html. This shared home directory is available to all YouMind skills — see shared/YOUMIND_HOME.md.

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

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

Dispatch Integration (Optional)#

This skill is self-contained. The youmind-article-dispatch hub is optional.

• Primary mode — standalone: Invoke directly ("Write a Tumblr post about X"). Works without other YouMind skills.
• Author voice lookup: This skill may read ~/.youmind/author-profile.yaml for cross-platform voice preferences.
• Optional dispatch-mode invocation: If dispatch passes resolved_author, use it as voice/audience context, but still obey Tumblr-native adaptation rules.
• Capability manifest: dispatch-capabilities.yaml tells dispatch that Tumblr is strongest for conversational long-form posts, image-led updates, and feedback-aware iteration.

Content Modes#

Before writing, read references/platform-dna.md.

Intent routing#

User inputOperationPlaybookTopic / rough ideaGeneratereferences/content-generation-playbook.mdExisting article / Markdown draftAdaptreferences/content-adaptation-playbook.mdExisting image + short anglePhoto postreferences/media-playbook.mdExisting Tumblr post ID + comments questionFeedback reviewreferences/engagement-playbook.mdQueue/order requestQueue managementreferences/engagement-playbook.md

Critical quality rules#

1. Tumblr-first, not CMS-first: do not dump raw SEO blog structure into Tumblr.
2. Opening paragraph must work in-feed: the first screen should justify the click.
3. Choose the right format: use photo posts when the image is the object, not just decoration.
4. Simple HTML only: avoid scripts, fragile embeds, and layout-heavy markup.
5. Tags are discovery cues, not keyword stuffing: 3-8 focused tags beats a long noisy list.
6. Notes matter more than vanity polish: write for reblogs, replies, and quotable lines.
7. Never hand-wave result links: return the exact post URL when available, otherwise the blog URL fallback.

Result Links Rule#

After any publish action, always end with Result links.

• Prefer the direct Tumblr post URL
• If no exact post URL is available, return the best blog URL instead
• Never leave the user with only a raw post ID

Pipeline Overview#

See references/pipeline.md for the detailed workflow.

• Text publishing lane: topic → draft → HTML adaptation → publish
• Photo publishing lane: choose format → caption shaping → image post publish
• Feedback lane: notes / notifications / followers / limits → insight extraction
• Queue lane: draft / queue review → reorder / shuffle → republish decision

Resilience#

Every major action has a fallback:

• Text publish fails → save adapted HTML locally
• Photo publish fails → save caption HTML locally and return the image URL
• Notes endpoint fails → fall back to notifications + blog URL guidance
• Exact post URL missing → use the blog-level Tumblr URL

If a step and its fallback both fail, note it clearly and continue with the rest of the workflow.