| name | matrixorigin-blog-new-article |
| description | Use when creating a new article in matrixorigin-blog, choosing matrixorigin or memoria, creating the slug directory, setting frontmatter, adding local images or videos, validating content, and preparing a scoped PR. |
MatrixOrigin Blog New Article
Use this skill for new posts in matrixorigin-blog.
Owner Map
- Authoring rules:
README.md
- Frontmatter contract:
schema/frontmatter.ts
- Workflow checklist:
docs/AGENT-WORKFLOWS.md
- PR template:
docs/agent-templates/pr-body.md
Workflow
- Confirm the target project directory:
matrixorigin/ for MatrixOrigin company blog content.memoria/ for Memoria product blog content.
- Confirm the slug is lowercase, ASCII, hyphen-separated, and URL-safe.
- Create
<project>/<slug>/index.md.
- Put article-local images under
<project>/<slug>/images/.
- Put article-local videos under
<project>/<slug>/videos/ if needed.
- Start
index.md with YAML frontmatter at the first byte.
- Include required fields from
schema/frontmatter.ts: title, date, and
description.
- Default to
status: "draft" unless the user explicitly wants a published
article.
- Use
./images/<filename> for local image references.
- Run
pnpm validate.
- Check
git diff --stat and ensure only intended article files changed.
Common Failure Modes
- Creating content in the wrong top-level project directory.
- Leaving a blank line before frontmatter.
- Omitting
description.
- Marking content as
published when the user only asked for a draft.
- Referencing images outside the article directory.
Verification
- Content creation:
pnpm validate
- PR body: use
docs/agent-templates/pr-body.md
