---
name: blog-adding
description: Add a new blog post to this Docusaurus site from a staging folder.
---
# Add a Blog Post
Use this skill when the user asks to add a new blog post
## Steps
1. Choose a blog folder name `YYYY-MM-DD-short-slug` (use the current date unless the user specifies one).
2. Create `blog/<folder>/index.md` with front matter:
- `description`: short summary string
- `slug`: URL slug without date
- `image`: `/img/blogs/<folder>/cover.<ext>`
- `tags`: array (e.g. `[MoonBit]`)
3. Add the H1 title and insert a cover image near the top: ``.
4. Copy the staging Markdown content into the blog `index.md` after the front matter and cover.
5. If the post includes videos, follow the existing pattern (see `blog/2024-04-18-ai-coding`):
- Place `.mp4` (or `.webm`) files in `blog/<folder>/`.
- Add `import` statements at the top of `index.md`.
- Use `<video controls src={videoImport} style={{width: '100%'}}></video>` in the body.
6. Copy referenced images/assets into `blog/<folder>/` and ensure all `./image` links resolve.
7. Pick a cover image.
8. Copy the cover into `static/img/blogs/<folder>/cover.<ext>` for the meta image path.
9. If the staging post is English-only, Add a zh placeholder for English-only posts:
- Create `i18n/zh/docusaurus-plugin-content-blog/<folder>/index.md` with:
```
---
unlisted: true
---
```
If the staging post includes Chinese content, Repeat steps 2-6 for the Chinese version in `i18n/zh/docusaurus-plugin-content-blog/<folder>/index.md`.
10. Remove the staging folder
## Notes
- No Docusaurus config changes are required; the blog plugin picks up new folders automatically.
- Keep file paths and front matter ASCII-safe; avoid introducing new non-ASCII unless required.
