Hexo Skill for Claude Code

A comprehensive Claude Code skill for managing Hexo static blog sites.

Overview

This skill enables Claude to help you with all aspects of Hexo blog development, including:

• 🚀 Initializing new Hexo sites
• 📝 Creating posts, pages, and drafts
• 🎨 Creating custom layouts and scaffolds
• 📤 Publishing and deploying content
• ⚙️ Configuration and troubleshooting

Installation

Option 1: Local Project Skill

1. Copy the skill to your project:

   mkdir -p .claude/skills
   cp -r path/to/hexo-skill/.claude/skills/hexo .claude/skills/

2. The skill will be available when you open the project in Claude Code

Option 2: Global Skill

1. Copy the skill to your global Claude skills directory:

   mkdir -p ~/.claude/skills
   cp -r path/to/hexo-skill/.claude/skills/hexo ~/.claude/skills/

2. The skill will be available in all your Claude Code sessions

Option 3: Clone This Repository

# Clone to your project
cd your-hexo-project
git clone https://github.com/yourusername/hexo-skill .claude

Usage

The skill is automatically invoked when you mention Hexo-related tasks:

Examples

Initialize a new Hexo site:

Create a new Hexo blog called "my-awesome-blog"

Create a blog post:

Create a new Hexo post titled "Getting Started with Hexo"

Create a custom layout:

Create a custom Hexo scaffold for photo gallery posts

Generate and deploy:

Generate and deploy my Hexo site

Troubleshooting:

My Hexo site isn't updating after I made changes

Features

Core Operations

• Site Initialization - Set up new Hexo projects with proper structure
• Content Creation - Generate posts, pages, and drafts with proper front-matter
• Custom Layouts - Create and use custom scaffolds for different content types
• Publishing - Manage drafts and publish content
• Generation - Build static site files
• Development Server - Run local preview server
• Deployment - Deploy to various hosting platforms

Reference Materials

The skill includes comprehensive reference documentation:

• Commands Reference - Detailed guide to all Hexo CLI commands
• Front-Matter Guide - Complete documentation of front-matter fields
• GitHub Pages Deployment Guide - Step-by-step instructions for deploying to GitHub Pages
  • GitHub Actions setup (recommended)
  • hexo-deployer-git configuration
  • Authentication methods (SSH, personal access tokens)
  • Custom domain setup
  • Troubleshooting deployment issues
• Custom Scaffold Examples - Ready-to-use templates for various content types:
  • Photo galleries
  • Project showcases
  • Tutorials
  • Video posts
  • Link posts
  • Book reviews
  • Recipes

Smart Assistance

Claude will:

• ✅ Check prerequisites before operations
• ✅ Suggest best practices
• ✅ Help troubleshoot common issues
• ✅ Provide configuration recommendations
• ✅ Guide you through workflows
• ✅ Explain command options and flags

Requirements

To use this skill effectively, ensure you have:

• Node.js 20.19.0 or later
• Git
• hexo-cli installed globally (npm install -g hexo-cli)

Skill Structure

.claude/skills/hexo/
├── SKILL.md                          # Main skill definition
├── examples/
│   └── custom-scaffold.md            # Custom scaffold examples
└── references/
    ├── commands.md                   # Hexo commands reference
    └── front-matter.md               # Front-matter guide

Examples

Initialize and Create First Post

You: "Initialize a new Hexo blog and create my first post"

Claude: Will help you:

1. Run hexo init with appropriate folder name
2. Install dependencies
3. Configure _config.yml
4. Create a new post
5. Start the development server

Create Custom Photo Gallery Layout

You: "Create a custom layout for photo gallery posts"

Claude: Will help you:

1. Create a custom scaffold in scaffolds/photo.md
2. Include appropriate front-matter fields
3. Show you how to use it with hexo new photo "title"
4. Explain customization options

Troubleshoot Deployment Issues

You: "My Hexo deployment is failing"

Claude: Will help you:

1. Check deployment configuration in _config.yml
2. Verify deployment plugin installation
3. Test Git credentials and access
4. Guide you through the fix

Configuration

The skill respects Hexo's standard configuration in _config.yml and works with:

• All official Hexo themes
• Standard Hexo directory structure
• Custom deployment configurations
• Multiple deployment targets

Customization

You can extend the skill by:

1. Adding your own scaffold examples to examples/
2. Creating project-specific reference materials
3. Adding custom workflows for your team

Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a feature branch
3. Add your improvements
4. Submit a pull request

License

MIT License - feel free to use and modify for your needs.

Support

For issues or questions:

• Check the Hexo official documentation
• Review the skill's reference materials
• Ask Claude for help with specific Hexo tasks

Changelog

v1.0.0 (2026-03-05)

• Initial release
• Core Hexo operations support
• Comprehensive command reference
• Front-matter documentation
• Custom scaffold examples
• Common workflows and troubleshooting

Acknowledgments

• Built for Claude Code by Anthropic
• Hexo documentation and community
• Contributors and testers

---

Made with ❤️ for the Hexo and Claude Code communities