seo-writer SKILL.md skillA

seo-writer from jeffallan/writing-with-agents is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jeffallan/writing-with-agents/seo-writer@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jeffallan/writing-with-agents
Path
plugin/skills/seo-writer/SKILL.md
Versions recorded
6
Latest version
v1.0.0, committed Oct 30, 2026
First version recorded
Oct 5, 2026
Size
10,920 bytes
Repository stars
37
License
MIT

Use when writing content targeting search visibility, optimizing articles for keywords and featured snippets, planning SEO-aware heading architecture, or validating on-page SEO elements.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# SEO Writer

## Role Definition

The SEO Writer is the search optimization integration specialist. This is a cross-cutting skill that provides SEO guidance during the Architect (planning), Carpenter (execution), and Judge (validation) phases. It does not replace those phases -- it augments them with search-aware decisions.

**Lead:** AI analyzes search intent, maps keywords, and runs SEO validation.
**Support:** Human confirms keyword targets, approves heading architecture, and decides trade-offs between readability and optimization.

The SEO Writer understands search intent classification, keyword-to-heading mapping, heading architecture for crawlability, featured snippet targeting patterns, and E-E-A-T signals. It applies these across the writing workflow rather than as an afterthought bolted onto a finished draft.

## When to Use This Skill

- When the content goal includes organic search visibility
- When you need to analyze search intent before planning content structure
- When mapping keywords to headings during the Architect phase
- When targeting featured snippets or People Also Ask boxes
- When integrating keywords naturally during the Carpenter phase
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jeffallan/writing-with-agents/seo-writer@sha256:a081f23c7c2c7006

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mktzetssktt5lgav.svg)](https://markdownregistry.com/a/art_mktzetssktt5lgav)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Oct 5, 2026 and Oct 30, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-10-30 34674e4 10,920 BA view · diff
v1.0.02026-10-14 20359ea 10,664 BA view · diff
v1.0.02026-10-14 2666792 10,906 BA view · diff
v1.0.02026-10-05 437c787 9,630 BA view · diff
v1.0.02026-10-05 6f66b81 9,405 BA view · diff
v1.0.02026-10-05 ca8bb23 10,258 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10920 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jeffallan/writing-with-agents · 37 stars · license MIT · pushed 2026-10-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mktzetssktt5lgav
GET https://markdownregistry.com/api/v1/resolve?ref=jeffallan/writing-with-agents/seo-writer
GET https://markdownregistry.com/api/v1/blob/a081f23c7c2c70061a399afa13b3b0387ad2574209c3c0d95bb9c8ec0590b570

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jeffallan/writing-with-agents

CLAUDE.md CLAUDE.md file
jeffallan/writing-with-agents · CLAUDE.md
git:20261030.1eee213 · audit A · 37 stars
architect SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/architect/SKILL.md · Use when organizing raw material into a coherent structure, defining the throughline of a piece, building an outline…
v1.0.0 · audit A · 37 stars
carpenter SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/carpenter/SKILL.md · Use when writing prose from a structured outline, building draft content section by section, or constructing clear…
v1.0.0 · audit A · 37 stars
content-strategist SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/content-strategist/SKILL.md · Use when planning a multi-article content strategy from a research corpus, creating domain maps for content topology…
v1.0.0 · audit A · 37 stars
judge SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/judge/SKILL.md · Use when editing a draft, checking for AI voice patterns, reviewing prose quality, running readability analysis…
v1.0.0 · audit A · 37 stars
knowledge-harvester SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/knowledge-harvester/SKILL.md · Use when capturing research artifacts to a vault or knowledge base, formatting source citations, saving synthesized…
v1.0.0 · audit A · 37 stars
madman SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/madman/SKILL.md · Use when brainstorming ideas, generating raw material, or starting the creative phase of a writing project. Invoke for…
v1.0.0 · audit A · 37 stars
quality-rubric SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/quality-rubric/SKILL.md · Use when scoring finished content against quality dimensions, evaluating whether a piece meets publishable standards…
v1.0.0 · audit A · 37 stars
research-intake SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/research-intake/SKILL.md · Use when ingesting source material for a writing project, building a knowledge map from notes and documents…
v1.0.0 · audit A · 37 stars
whirlybird SKILL.md skill
jeffallan/writing-with-agents · plugin/skills/whirlybird/SKILL.md · Use when creating nonlinear outlines, generating mindmap diagrams for article structure, mapping a knowledge domain…
v1.0.0 · audit A · 37 stars

Every file in jeffallan/writing-with-agents

Browse by kind, by grade A, or by owner.