Overview
The blog-hexo skill merges the drafting and publishing flows so you can go from first idea to deployed post without context switching. This note explains how to use each mode and what to watch out for.
Draft mode checklist
- Confirm basics – topic, keywords, audience, tone, and target word count.
- Pick the path – check memory or ask where the Markdown file should live (default:
source/_posts/). - Front matter – paste the standard block with
published: false, header image, date, and tags. - Write the content – intro, H2/H3 sections, conclusion. Mention any TODOs inline if something needs user input.
- Stay local – it’s fine to run
npx hexo clean && npx hexo generatefor previews;published: falsekeeps the draft out of production. - Hand-off signal – note whether the draft is ready for review or still in progress.
Publish mode checklist
- Gather SEO inputs – target + secondary keywords, search intent, audience, tone, desired word count.
- Polish the structure – apply the SEO framework (title under 60 chars, compelling meta, target keyword in first 100 words, H2/H3 coverage, bullet lists, snippet-ready answers).
- Verify links – add internal links to related posts and 2-3 reputable external sources where relevant.
- Image notes – suggest placements + alt text if the post could benefit from visuals.
- Hexo deploy – run
npx hexo clean,npx hexo generate,npx hexo deployto publish to GitHub Pages once the user removespublished: false. - Document changes – summarize what was rewritten, optimized, or linked in the status update.
Promoting a draft to publish
- Remove
published: falsefrom the front matter. - Re-run the publish mode checklist.
- Deploy with the Hexo commands and capture the commit hash from
hexo deploylogs.
Tips
- Keep front matter tidy so future agents can parse it quickly.
- When in doubt about path, tags, or tone, ask before writing.
- Mention which mode you used (Draft or Publish) in task updates for clarity.
ClawHub skill
- Install via ClawHub: https://clawhub.ai/Jarxi/hexo-blog-with-seo
