hexo-blog-update

name	hexo-blog-update
description	Use when creating, editing, or publishing Hexo blog posts
metadata	{"author":"dqz00116"}

Hexo Blog Update Skill

Overview

Standardized workflow for creating, editing, and publishing Hexo blog posts.

When to Use

Use this skill when you need to:

• Create a new blog post
• Edit existing blog posts
• Preview blog locally before publishing
• Deploy blog to production

Prerequisites

• Node.js installed (>= 14)
• Hexo CLI installed globally (npm install -g hexo-cli)
• Blog repository cloned locally
• Git configured with SSH key for deployment

Workflow

Step 1: Create New Post

# Navigate to blog directory
cd /path/to/blog

# Create new post
hexo new post "post-title"

# Or use npm script
npm run new "post-title"

Post will be created at: source/_posts/post-title.md

Step 2: Edit Post Content

Edit the generated markdown file with the following structure:

---
title: Post Title
date: YYYY-MM-DD HH:MM:SS
categories:
- Category 1
- Category 2
tags:
- Tag 1
- Tag 2
---

Post excerpt content, will be displayed in the homepage list...

<!--more-->

## Body Heading

Body content...

## Another Heading

More content...

Important Rules:

• ✅ Use <!--more--> to separate excerpt from full content
• ✅ Set proper categories and tags
• ✅ Use Chinese for Chinese blogs
• ✅ Keep front matter (YAML between ---) at the top

Step 3: Local Preview

# Start local server
hexo server

# Or with npm
npm run server

Access at: http://localhost:4000

Preview Checklist:

• Post appears in list with correct title
• Excerpt shows correctly (before <!--more-->)
• Full content displays properly
• Categories and tags are correct
• No formatting errors

Step 4: Deploy to Production

# Deploy (clean + generate + deploy)
npm run release-blog

# Or manually
hexo clean && hexo generate && hexo deploy

Deployment Output:

INFO  Deploy done: git
To github.com:username/username.github.io.git
   xxx...xxx  HEAD -> master

Standard Post Template

---
title: Post Title
date: 2026-02-11 17:20:00
categories:
- Category 1
- Category 2
tags:
- Tag 1
- Tag 2
- Tag 3
---

Post excerpt, displayed in the homepage list. Briefly introduce the article content and value.

<!--more-->

## Preface

Detailed background introduction...

## Main Content

### Section 1

Content...

### Section 2

Content...

## Summary

Summary of key points...

---

*Related Links*:
- [Link Description](url)

Common Commands Reference

Command	Description
hexo new post "title"	Create new post
hexo new draft "title"	Create draft post
hexo publish draft "title"	Publish draft
hexo server	Start local server
hexo clean	Clean cache and generated files
hexo generate	Generate static files
hexo deploy	Deploy to remote
npm run release-blog	Full deploy pipeline

File Structure

blog/
├── source/
│   └── _posts/
│       └── post-title.md      # Post files
├── themes/                    # Theme directory
├── _config.yml               # Site config
├── package.json              # Scripts & dependencies
└── public/                   # Generated output (auto)

Best Practices

Do's

✅ Always preview before deploying ✅ Use meaningful categories and tags ✅ Include <!--more--> for proper excerpt ✅ Check date format (YYYY-MM-DD HH:MM:SS) ✅ Verify deployment success message

Don'ts

❌ Don't modify public/ directory directly ❌ Don't forget to set categories/tags ❌ Don't skip local preview ❌ Don't use special characters in filenames

Troubleshooting

Post not showing in list

• Check if file is in source/_posts/
• Verify front matter format
• Run hexo clean and regenerate

Deployment fails

• Check SSH key configuration
• Verify git remote is correct
• Ensure network connectivity

Formatting issues

• Use standard Markdown syntax
• Verify YAML front matter syntax
• Check theme compatibility

Example Session

User: Create a new blog post about AI tools

Agent:

Step 1: Create post
$ hexo new post "Recommended AI Development Tools"
INFO  Created: source/_posts/Recommended-AI-Development-Tools.md

Step 2: Edit content
[Edit file with proper structure and <!--more-->]

Step 3: Preview
$ hexo server
INFO  Hexo is running at http://localhost:4000/
[Verify post displays correctly]

Step 4: Deploy
$ npm run release-blog
INFO  Deploy done: git

Version History

• v1.0 (2026-02-11) - Initial release
  • Standard 4-step workflow
  • Chinese blog format support
  • Common commands reference

---

Source: dqz00116/skill-lib — distributed by TomeVault.