
Blog Review
Reviews blog posts against voice, structure, SEO and accuracy standards.
Install
npx skills add appwrite/appwrite --skill reviewing-blogs -g -a claude-code -y- Repository
- appwrite/appwrite57.8k
- Category
- Writing
- Updated
- 3d ago
- License
- BSD-3-Clause
- Context cost
- Mediumabout 1,865 tokens
- Runs scripts
- No, instructions only
What it does
Reviews and critiques blog posts in src/content/blog/posts/ against Appwrite's established standards for voice, tone, structure, SEO, formatting, and accuracy. Use when the user asks to review, audit, critique, or improve an existing blog post.
Repository layout (apps/console)
This skill targets the Console app at apps/console in appwrite/appwrite; paths are relative to it. Path mapping from the upstream appwrite/website skills:
| Artifact | Path |
|---|---|
| Blog post | src/content/blog/posts/<slug>.markdoc |
| Docs page | src/content/docs/{path}/index.markdoc |
| Changelog entry | src/content/changelog/entries/<YYYY-MM-DD>.markdoc |
| Cover image | public/images/blog/<slug>/cover.avif (min 1200px wide; run bun run generate:cover-manifest after adding) |
Also apply the unslop skill to all user-facing prose.
Blog Review
How to run a review
When asked to review a blog post, read the file at src/content/blog/posts/<slug>.markdoc, then evaluate it against every section below. Produce a structured report using the format at the end of this document.
Before starting: Identify which sections of src/content/docs/ are relevant to the post's topic, then read those index.markdoc files directly to use as the ground truth for the accuracy review. The docs map to public URLs as src/content/docs/{section}/{subsection}/index.markdoc → https://appwrite.io/docs/{section}/{subsection}. Key sections: products/{auth,databases,storage,functions,messaging,sites,ai}/, quick-starts/, tutorials/, advanced/{platform,security,self-hosting}/, apis/, tooling/.
Review checklist
Frontmatter
-
layout: postis present -
titleis a quoted string, 50-60 characters, front-loads the primary keyword -
descriptionis 150-160 characters, includes the primary keyword, states what the reader will learn -
dateis inYYYY-MM-DDformat -
coverpath matches the slug:/images/blog/<slug>/cover.avif -
timeToReadis plausible given word count (roughly 200-250 wpm) -
authoris set -
categoryis set -
featuredandunlistedare present
