# Hexo Blog Update > Use when creating, editing, or publishing Hexo blog posts - Skill: `tomevault-io/hexo-blog-update` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/hexo-blog-update` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/hexo-blog-update/raw - Safety review: pending (external: skill-scanner PASS, skillspector WARNING) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/hexo-blog-update --- # 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 ```bash # 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: ```markdown --- 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... ## Body Heading Body content... ## Another Heading More content... ``` **Important Rules**: - ✅ Use `` 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 ```bash # 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 ``) - [ ] Full content displays properly - [ ] Categories and tags are correct - [ ] No formatting errors ### Step 4: Deploy to Production ```bash # 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 ```markdown --- 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. ## 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 `` 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 ] 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](https://github.com/dqz00116/skill-lib) — distributed by [TomeVault](https://tomevault.io).