shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 其它需要 API Key

youmind-tumblr-article

使用AI编写并发布原生Tumblr帖子——通过YouMind知识库塑造主题、Tumblr优先的长文写作、图片主导的发布、笔记/活动等

person作者: mindy-youmindhubclawhub
open_in_new仓库download下载资源包

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.

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:

cd toolkit && node dist/cli.js validate

Skill Directory

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

| Path | Purpose | When to read | |------|---------|-------------| | references/platform-dna.md | Tumblr surfaces, reblog/notes logic, visual-fit decisions | Before any content work | | references/pipeline.md | End-to-end execution lanes | Before running the workflow | | references/content-generation-playbook.md | Topic → Tumblr-native text/photo post | When generating from an idea | | references/content-adaptation-playbook.md | Existing article/image → Tumblr-native version | When adapting or cross-posting | | references/media-playbook.md | When to use photo post vs text post with lead image | Before image-led publishing | | references/engagement-playbook.md | Notes / notifications / followers / limits review | When reading feedback | | references/api-reference.md | YouMind Tumblr OpenAPI + CLI contract | When 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 input | Operation | Playbook | |------------|-----------|----------| | Topic / rough idea | Generate | references/content-generation-playbook.md | | Existing article / Markdown draft | Adapt | references/content-adaptation-playbook.md | | Existing image + short angle | Photo post | references/media-playbook.md | | Existing Tumblr post ID + comments question | Feedback review | references/engagement-playbook.md | | Queue/order request | Queue management | references/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.