# Hexo Blog Update > Use when creating, editing, or publishing Hexo blog posts - **Type:** Skill - **Install:** `agentstack add skill-dqz00116-skill-lib-hexo-blog-update` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [Dqz00116](https://agentstack.voostack.com/s/dqz00116) - **Installs:** 0 - **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Dqz00116](https://github.com/Dqz00116) - **Source:** https://github.com/Dqz00116/skill-lib/tree/main/hexo-blog-update ## Install ```sh agentstack add skill-dqz00116-skill-lib-hexo-blog-update ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # 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 & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [Dqz00116](https://github.com/Dqz00116) - **Source:** [Dqz00116/skill-lib](https://github.com/Dqz00116/skill-lib) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-dqz00116-skill-lib-hexo-blog-update - Seller: https://agentstack.voostack.com/s/dqz00116 - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.