11zhouxuan/11zhouxuan.github.io/11zhouxuan-github-io
Claude Code and agent skill by 11zhouxuan/11zhouxuan.github.io
- community
Checking that the SKILL.md file is still in the repository.
Install
npx vskill@latest install 11zhouxuan/11zhouxuan.github.io/11zhouxuan-github-ioSKILL.md
The same SKILL.md was published earlier as 11zhouxuan/11zhouxuan.github.io/11zhouxuan-github-io.
Blog Writing Skill for 11zhouxuan.github.io
This document describes how to write blog posts for this Hexo + NexT theme blog. Any AI agent should follow these rules when creating or editing posts.
Tech Stack
- Static Site Generator: Hexo
- Theme: NexT v8.27.0, Mist scheme (top navigation bar)
- Markdown Renderer:
hexo-renderer-markdown-it(does NOT interfere with LaTeX) - Math Rendering: MathJax (enabled per-post via
mathjax: truein front matter) - Deployment: GitHub Actions → push to
main→ auto-build → deploy togh-pages - Custom CSS:
source/_data/styles.styl - Site URL: https://11zhouxuan.github.io/
Post File Location
All posts go in source/_posts/. Use kebab-case filenames, e.g., flow-matching-three-steps.md.
Front Matter Template
Bilingual (EN/ZH) Structure
Use language toggle buttons and <div> blocks:
Add the switchLang() script at the end of the post. Reference implementation:
Math Formula Rules
We use hexo-renderer-markdown-it which does NOT interfere with LaTeX syntax. Write standard LaTeX freely:
What works directly (no escaping needed):
$X_0$,$p_1$,$v_t^\theta$— underscores work normally\quad,\qquad,\enspace— letter-based spacing commands work\lVert,\rVert— norm notations work\\inalignedenvironments — works normally\big(,\Big(,\mathrm,\mathbbetc. — all letter-based commands work
BROKEN (markdown-it escapes backslash + ANY ASCII punctuation):
\,— renders as literal,. Use a regular space instead.\;— renders as literal;. Use `\enspace` or `\quad` instead.\!— renders as literal!. Avoid.\:— renders as literal:. Avoid.
Rule of thumb: Any \ followed by a non-letter character will be escaped. Only use \ + letters (like \quad, \enspace, \lVert, \mathrm{}).
BROKEN (markdown emphasis eats _ and * inside math)
markdown-it applies emphasis rules before MathJax sees the formula. When two _ (or two *) in the same formula happen to pair up, the text between them becomes <em> and the subscript/superscript is destroyed:
\hat{Z}_1 ... \sup_{t \in [0,1]}→ the two_pair →\hat{Z}<em>1 ... \sup</em>{t ...v_t^{\pi^*}(x) = \nabla\Psi^*(z_0)→ the two*pair →\pi^<em>}(x) = \nabla\Psi^</em>(
Fixes:
- Subscripts: escape as
\_— e.g.\mathcal{L}\_{\mathrm{CFM}},\sup\_{t \in [0,1]},\hat{Z}\_1. (Safe to always escape; MathJax treats\_as_.) - Superscript star: write
^{\ast}instead of^*— e.g.\pi^{\ast},\nabla\Psi^{\ast}.
How to detect: after hexo generate/serve, grep the rendered HTML for <em> inside $...$ / $$...$$. Any hit is a broken formula.
Display math
Use $$...$$ on its own line:
Inline math
Use $...$ for inline math: $X_0 \sim p_0$
Multi-line equations
aligned environments with \\ work:
Equation numbering and cross-references
Use \tag{N} for numbering and \label{eq:name} for cross-referencing:
Reference equations in text with $\eqref{eq:ode}$ — MathJax renders this as a clickable (1) that jumps to the equation.
For bilingual posts, use language-suffixed labels: \label{eq:ode-zh} and \label{eq:ode-en} to avoid conflicts between hidden/visible sections.
Footnotes
Use traditional bottom-of-article footnotes with anchor links (NOT sidenotes):
In-text reference:
At the bottom of the article:
The CSS removes underlines from these footnote links. Do NOT use markdown-style [1] references — they get interpreted as link references by the markdown parser.
NexT Tag Plugins (Callout Boxes)
Use these for highlighted content blocks:
Available types: info (blue), danger (red), success (green), warning (orange), default (grey).
Styling Notes
- Body font: Source Serif 4 + Noto Serif SC (serif, academic style)
- Headings: Source Sans 3 + Noto Sans SC (sans-serif)
- Code: JetBrains Mono
- Content width: 780px centered
- TOC: Default hidden in sidebar; user clicks hamburger icon to open;
toc.number: false
Mobile Considerations
- All content forced to
max-width: 100%on mobile - Math formulas have
overflow-x: autofor horizontal scrolling on small screens - NEVER use
float: rightor largepadding-right— these cause "grey right half" on mobile - NEVER use sidenotes/margin notes — they overflow on mobile
Deployment
Just push to main branch. GitHub Actions will:
- Run
npx hexo generate - Deploy
./publictogh-pagesbranch - Site is live at https://11zhouxuan.github.io/
No manual build steps needed. Wait ~1-2 minutes after push for deployment to complete.
Common Pitfalls Summary
| Problem | Cause | Fix | |
|---|---|---|---|
| Footnote has underline | Theme default link style | Already fixed in CSS | |
| Mobile right-half grey | float: right or padding | Never use side-floats | |
[1] disappearing | Markdown interprets as link ref | Wrap in <a><sup>[1]</sup></a> | |
| Equation tag not showing | Missing \tag{N} | Add \tag{N} at end of display math | |
| Inline math on own line | CSS display:block on mjx-container | Fixed — only display math is block |
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingSKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/11zhouxuan/11zhouxuan.github.io/11zhouxuan-github-io)