Skills

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:

ArtifactPath
Blog postsrc/content/blog/posts/<slug>.markdoc
Docs pagesrc/content/docs/{path}/index.markdoc
Changelog entrysrc/content/changelog/entries/<YYYY-MM-DD>.markdoc
Cover imagepublic/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: post is present
  • title is a quoted string, 50-60 characters, front-loads the primary keyword
  • description is 150-160 characters, includes the primary keyword, states what the reader will learn
  • date is in YYYY-MM-DD format
  • cover path matches the slug: /images/blog/<slug>/cover.avif
  • timeToRead is plausible given word count (roughly 200-250 wpm)
  • author is set
  • category is set
  • featured and unlisted are present

Slug consistency

Read the whole SKILL.md on GitHub

More in Writing