skills: add content-seo-geo (SEO + GEO page optimization)

[vanrensbird]

What

Adds a new agent skill, .claude/skills/content-seo-geo/SKILL.md, for optimizing prisma.io pages for search engines and AI answer engines, and wires it into content-write-blog as the post-drafting optimization step.

Reviewed and approved by Martin (draft iterated in Notion before this PR).

The skill

• Primary goal stated up front: being cited by AI engines ranks above search engine rankings, with a trade-off rule for when the two conflict.
• Seven ordered steps, each with a checkable completion criterion (Matt Pocock's skill-writing method): name the target queries (primary + fan-out) and pick a citable format; answer-first lead carrying the canonical internal links; structure for passage extraction (question-shaped headings, comparison tables, FAQ accordions with the site's <Accordions> markup, no inline TOC since the layout renders InlineTOC); citable claims (sourced statistics, real quotations, exact behavior from real output, everything verified); entity + freshness signals (updatedAt + Updated callout); metadata; and verify against the served HTML rather than the source file.
• Complements content-write-blog rather than duplicating it: drafting conventions (author, frontmatter, link rules, writing quality) stay there; this skill points to it.
• Research findings (Princeton GEO study, most-cited content types) are folded into the steps as writing instructions instead of a reference appendix, so they change what authors produce.
• Based on the Promptwatch GEO skills and the patterns proven on the NestJS series refresh (Refresh: Building a REST API with NestJS and Prisma (Prisma 7 / NestJS 11) #7977, Blog refresh: NestJS + Prisma series parts 2-5 (Prisma 7 / NestJS 11) #8034, Blog: apply reviewed template to NestJS series parts 3-5 #8035).

content-write-blog changes

One line in the Step 9 hand-off (next-step instruction now includes running content-seo-geo on the fleshed-out draft) and a version bump to 2026.7.8.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added a new guided workflow for optimizing a page for search engines and AI answer engines, including query planning, content structure, citation quality, metadata, and final validation checks.
  • Updated the blog-writing guidance to include the new optimization step before creating a branch or draft pull request.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
blog	Ready	Preview, Comment	Jul 8, 2026 2:14pm
docs	Ready	Preview, Comment	Jul 8, 2026 2:14pm
eclipse	Ready	Preview, Comment	Jul 8, 2026 2:14pm
site	Ready	Preview, Comment	Jul 8, 2026 2:14pm

[coderabbitai]

Walkthrough

Adds a new content-seo-geo SKILL.md defining a 7-step SEO and AI-citation optimization checklist for Prisma.io pages (queries, lead paragraph, extractable structure, citable claims, freshness/entity signals, metadata, HTML verification). Updates content-write-blog SKILL.md's version and Step 9 to invoke this new skill before git/PR steps.

Changes

SEO/GEO Skill Documentation

Layer / File(s)	Summary
New content-seo-geo skill definition .claude/skills/content-seo-geo/SKILL.md	Defines frontmatter and a 7-step checklist covering target queries, lead-paragraph answer requirements, extractable content structure (with FAQ accordion template), citable claims, freshness/entity signals, metadata rules, and rendered-HTML verification.
Wire content-seo-geo into content-write-blog handoff .claude/skills/content-write-blog/SKILL.md	Bumps skill version and updates Step 9 to run content-seo-geo before branching, committing, pushing, and opening a draft PR.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• prisma/web#7975: Introduces the same content-write-blog SKILL.md whose version and Step 9 handoff instruction are modified in this PR.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: adding the content-seo-geo skill for SEO and GEO page optimization.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	✅ No changes detected	-	Jul 8, 2026, 2:21 PM

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.claude/skills/content-seo-geo/SKILL.md:
- Line 3: The SKILL.md frontmatter `description` is too broad and is acting like
both a routing trigger and general prose, which causes overlap with
`content-write-blog`. Tighten the `description` on the SKILL frontmatter to a
single focused “Use when…” trigger that only targets SEO/GEO/AEO optimization
tasks for existing prisma.io content, and keep ordinary blog-writing prompts out
of the trigger; update the text in the `description` field accordingly.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a3eb845a-9d6c-40fe-ac7e-02aceae3b751

📥 Commits

Reviewing files that changed from the base of the PR and between 7b84d5d and 09ca7f4.

📒 Files selected for processing (2)

• .claude/skills/content-seo-geo/SKILL.md
• .claude/skills/content-write-blog/SKILL.md