# Edobry Minsky SEO Skill

> SEO Skill — Static Site Optimization

- Skill: `tomevault-io/edobry-minsky-seo-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/edobry-minsky-seo-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/edobry-minsky-seo-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/edobry-minsky-seo-skill

---


# SEO Skill — Static Site Optimization

> **Attribution:** Vendored from [aevans-eng/seo-skill](https://github.com/aevans-eng/seo-skill) (retrieved 2026-05-19). Minor edits: added frontmatter for Claude Code skill discoverability; replaced unicode check/cross with Y/N for ASCII compliance per CLAUDE.md `§Ensure ASCII Code Symbols`.

Lightweight audit and fix tool for static HTML sites (GitHub Pages, Netlify, Vercel, Astro static-output, etc.). No build tools required.

## Setup

Before using, provide Claude with:

- **Domain** (e.g. `https://yourname.com`)
- **Pages** list
- **Social profiles**
- **Target keywords** (what you want to rank for)

Claude retains this context for the session.

---

## What to Check

### 1. Per-Page Head Essentials

Each HTML page requires:

- `<title>` (50-60 chars): name + differentiator
- `<meta name="description">` (150-160 chars): unique, keyword-rich
- `<link rel="canonical">`: matches deployed URL exactly
- Open Graph tags: `og:title`, `og:description`, `og:image` (1200x630px)
- Twitter Card tags: `twitter:card`, `twitter:title`, `twitter:description`, `twitter:image`

### 2. Structured Data (JSON-LD)

Homepage should include:

- **Person** / **Organization** schema: name, jobTitle, affiliation, sameAs links, knowsAbout
- **WebSite** schema: name, URL

Project / product pages use **CreativeWork** or **SoftwareApplication** schema with name, author, description, URL.

_Rule:_ JSON-LD only. No FAQPage, HowTo, or placeholder text.

### 3. robots.txt

Create at site root:

```
User-agent: *
Allow: /
Sitemap: https://yourdomain.com/sitemap.xml
```

### 4. sitemap.xml

XML file listing all pages with `<loc>`, `<lastmod>` (YYYY-MM-DD), and `<priority>`.

### 5. Image SEO

- Descriptive `alt` text on all `<img>` tags
- WebP format preferred; under 200KB
- `loading="lazy"` for below-fold images
- OG image must be a real file

### 6. Content & Keywords

- One H1 per page including name/project name
- Proper heading hierarchy (h1 -> h2 -> h3)
- Your name appears naturally in body text
- Internal cross-linking between pages
- External links to social profiles

### 7. Technical Checks

- HTTPS throughout (all links and resources)
- Consistent trailing-slash convention
- No broken links
- Viewport meta tag on all pages
- Minimal/deferred JavaScript

### 8. Post-Deploy Verification

1. Verify `/robots.txt` and `/sitemap.xml` accessible
2. Test OG tags via social preview (Discord/Slack)
3. Submit sitemap in Google Search Console
4. Monitor `site:yourdomain.com` after a few days
5. Track target keyword rankings

### 9. Google Search Console

1. Add property for your domain
2. Verify via DNS or HTML file
3. Submit sitemap
4. Monitor Coverage report

---

## Audit Output Format

When invoked, read all HTML files and report:

| Check             | Status | Notes   |
| ----------------- | ------ | ------- |
| Meta descriptions | Y/N    | Details |
| OG tags           | Y/N    | Details |
| JSON-LD schema    | Y/N    | Details |
| robots.txt        | Y/N    | Details |
| sitemap.xml       | Y/N    | Details |
| Image alt text    | Y/N    | Details |
| H1 tags           | Y/N    | Details |
| Internal links    | Y/N    | Details |
| Canonical URLs    | Y/N    | Details |

Then offer to fix what's missing.

---
> Source: [edobry/minsky](https://github.com/edobry/minsky) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-15 -->