# Blog SEO Audit

Audits blog posts for SEO, structure, links, metadata, and search intent.

- Repository: https://github.com/appwrite/appwrite (57838 stars)
- Category: Marketing
- License: BSD-3-Clause
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add appwrite/appwrite --skill auditing-seo -g -a claude-code -y`
Codex: `npx skills add appwrite/appwrite --skill auditing-seo -g -a codex -y`
Cursor: `npx skills add appwrite/appwrite --skill auditing-seo -g -a cursor -y`
Gemini CLI: `npx skills add appwrite/appwrite --skill auditing-seo -g -a gemini-cli -y`

## Description

Audits Appwrite blog posts for SEO, AEO, content structure, links, metadata, and search intent. Use when the user asks for an SEO audit, SEO review, search optimization check, or pre-publishing SEO assessment.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 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.



# SEO Audit

## How to run an audit

When asked to audit a blog post, read `src/content/blog/posts/<slug>.markdoc` and evaluate every item below. Identify the primary keyword from the title, slug, headings, and content. If the target keyword remains ambiguous, state the keyword you inferred and ask the user to confirm it.

Before scoring:

1. Count title and `description` characters, including spaces.
2. Count body words, excluding frontmatter.
3. Read the relevant local files under `src/content/docs/` to verify Appwrite claims and internal doc links.
4. Check that internal and external links resolve when tools and network access allow it. Clearly mark any link you could not verify.

Do not rewrite the post unless the user asks. Report specific problems and exact fixes instead.

## SEO audit checklist

### Content essentials

The rest: https://github.com/appwrite/appwrite/blob/HEAD/apps/console/.cursor/skills/auditing-seo/SKILL.md