AI Hashnode Article Writer#

Write Hashnode articles with AI, then publish them through YouMind OpenAPI.

The local skill only requires a YouMind API key. The user's Hashnode token and publication are configured in YouMind, not in the local skill config.

Onboarding#

MANDATORY: When the user has just installed this skill, present this message immediately. Translate to the user's language.

AI Hashnode Article Writer installed!

Tell me your topic and I'll help write and publish it to Hashnode.

Try it now: "Write a Hashnode article about building APIs with GraphQL"

What it does:

• Research topics from your YouMind knowledge base and the web
• Write Hashnode-friendly technical articles with subtitle and SEO metadata
• Create Hashnode drafts by default
• Publish existing drafts when you're ready
• Show clear setup help if your Hashnode account is not yet connected in YouMind

One-time setup:

1. Install & build: cd toolkit && npm install && npm run build && cd ..
2. Create shared config: mkdir -p ~/.youmind/config && cp shared/config.example.yaml ~/.youmind/config.yaml
3. Fill youmind.api_key in ~/.youmind/config.yaml
4. In YouMind, connect Hashnode at https://youmind.com/settings/connector

Requirements:

• YouMind paid plan for article dispatch OpenAPI
• Hashnode connected in YouMind

Local Config#

Canonical shared config: put your YouMind credentials at ~/.youmind/config.yaml. You fill this ONCE and every YouMind skill reads from it. See shared/config.example.yaml and shared/YOUMIND_HOME.md.

Shape (identical in both locations):

yaml

youmind:
  api_key: "sk-ym-..."
  base_url: "https://youmind.com/openapi/v1"

This skill has no skill-specific overrides. All commands read youmind.api_key and youmind.base_url from ~/.youmind/config.yaml. Keep the documented domain as https://youmind.com/openapi/v1. If you test against a local youapi, override ~/.youmind/config.yaml — never the docs.

Do not ask the user to fill local hashnode.token or hashnode.publication_id. That flow is obsolete.

Draft Output Rule#

All locally generated article files must go under output/.

• Correct: skills/youmind-hashnode-article/output/my-post.hashnode.md
• Wrong: skills/youmind-hashnode-article/article.hashnode.md
• Wrong: any generated article directly in the skill root

output/ is git-ignored.

Directory Guide#

Read files on demand.

PathPurposetoolkit/src/cli.tsReal CLI used for validate / publish / list flowstoolkit/src/hashnode-api.tsYouMind OpenAPI client for Hashnodetoolkit/src/publisher.tsHigh-level publish wrappertoolkit/src/content-adapter.tsHashnode title / subtitle / tag / SEO adaptationreferences/platform-dna.mdHashnode audience, format constraints, community datareferences/content-generation-playbook.mdIdea → Hashnode-native draft workflowreferences/content-adaptation-playbook.mdExisting article → Hashnode-native workflowreferences/pipeline.mdStep-by-step execution flowreferences/api-reference.mdHashnode and YouMind OpenAPI contract summaryoutput/Local adapted markdown output

CLI Commands#

Run from toolkit/.

bash

node dist/cli.js validate
node dist/cli.js publish ../output/article.md --draft
node dist/cli.js publish ../output/article.md --publish
node dist/cli.js list --page 1 --limit 10
node dist/cli.js list-drafts --page 1 --limit 10
node dist/cli.js list-published --page 1 --limit 10
node dist/cli.js publish-draft <draft_id>
node dist/cli.js get-draft <draft_id>
node dist/cli.js get-post <post_id>
node dist/cli.js preview ../output/article.md
node dist/cli.js search-tags typescript

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 Hashnode 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. Without such a brief, the skill runs its own pipeline normally. Hashnode's depth-first DNA stays native to this skill.
• 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 Hashnode's real product surface: depth-first technical writing, subtitle + cover + canonical URL, series navigation, and developer-owned blog presentation.

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)Short piece to expand for HashnodeLocalize (depth)references/content-adaptation-playbook.md (localize mode)Old Hashnode post to refreshRevivereferences/content-adaptation-playbook.md (revive mode)Long piece → multi-post seriesCondense/splitreferences/content-adaptation-playbook.md (condense mode)Section from larger work → focused deep-diveExcerptreferences/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. Canonical URL: Set correctly for cross-posts (trailing slash matters)
4. User approval: Do not auto-publish without confirmation

Result Links Rule#

After any draft or publish action, always end with Result links.

• Prefer the public Hashnode post URL for published posts.
• For drafts, include the Hashnode dashboard URL when available.
• If no exact results page exists, return the best platform entry URL instead.
• Never leave the user with only a draft ID or post ID.

Behavior Rules#

1. Default to draft creation unless the user explicitly asks to publish immediately.
2. If Hashnode is not connected in YouMind, surface the connector URL: https://youmind.com/settings/connector
3. If the paid plan check fails, surface the pricing URL: https://youmind.com/pricing
4. Do not fall back to asking the user for local Hashnode tokens.
5. Keep tag guidance realistic: Hashnode tag lookup is exact or slug-like, not true fuzzy search.

Publishing Flow#

1. Load youmind.api_key
2. If the user supplied a topic, research and draft content
3. Adapt content with content-adapter.ts
4. Use publish --draft by default
5. If the user wants immediate publication, use publish --publish
6. Report draft vs published state clearly, including result links
7. For drafts, show the Hashnode dashboard URL when available
8. For published posts, include the public URL in result links

Failure Handling#

• Missing YouMind API key: tell the user to set youmind.api_key
• Hashnode not connected in YouMind: tell the user to open https://youmind.com/settings/connector
• Paid plan required: tell the user to open https://youmind.com/pricing
• Publish failure: keep the adapted markdown in output/ and report the backend error cleanly