Agent skill

SEO Fundamentals

by DanielPodolsky in DanielPodolsky/ownyourcode

Reviews SEO including meta tags, semantic HTML, and Open Graph.

MITAuto-check passedMarketing & SEO

Install SEO Fundamentals

skills CLI
$ npx skills add DanielPodolsky/ownyourcode --skill seo-fundamentals -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install DanielPodolsky/ownyourcode seo-fundamentals --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/DanielPodolsky/ownyourcode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/fundamentals/seo .claude/skills/seo-fundamentals && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-fundamentals
GitHub stars
290
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
389 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Reviews SEO including meta tags, semantic HTML, and Open Graph.

  • Works in 5 steps: Multiple H1 Tags → Missing Alt Text → Div Soup (No Semantic HTML) → …
  • Building public-facing pages
  • SKILL.md covers When to Apply, The SEO Checklist, Common Mistakes (Anti-Patterns) and Socratic Questions, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Fundamentals is an agent skill from DanielPodolsky/ownyourcode. Reviews SEO including meta tags, semantic HTML, and Open Graph. Use when building public-facing pages, adding title/description tags, or optimizing for search engines.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering On-page SEO. It works with Next.js and X (Twitter). The repository describes itself as: Claude Code workflow for AI-mentored development. Work efficiently with Spec-Driven Development and the 6 Gates. Built to fight cognitive offloading — for developers using AI to… The licence is MIT.

When your agent uses it

  • Building public-facing pages
  • Adding title/description tags
  • Optimizing for search engines

Example prompts

  • “Use the seo-fundamentals skill to review SEO including meta tags, semantic HTML, and Open Graph”
  • “/seo-fundamentals”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Multiple H1 Tags
  2. Missing Alt Text
  3. Div Soup (No Semantic HTML)
  4. Skipping Heading Levels
  5. Generic Title Tags

What it can do on your machine

Read from SKILL.md and the folder at commit bd1f17c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html and typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Fundamentals loads about 1.4k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 389 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from DanielPodolsky/ownyourcode at commit bd1f17c, republished under its MIT licence (© DanielPodolsky). 389 words, ~1,350 tokens.

Download SKILL.mdSave it as .claude/skills/seo-fundamentals/SKILL.md (or your agent's skills folder).
name
seo-fundamentals
description
Reviews SEO including meta tags, semantic HTML, and Open Graph. Use when building public-facing pages, adding title/description tags, or optimizing for search engines.

SEO Fundamentals Review

"Good SEO is good UX. If search engines can't understand your page, users might not find it."

When to Apply

Activate this skill when:

  • Reviewing HTML <head> sections
  • Seeing meta tags in code
  • Next.js/Remix page components
  • HTML structure with headings
  • Any page that should be indexed

The SEO Checklist

Must Have (Every Page)
  • Title tag — 50-60 characters, unique per page
  • Meta description — 150-160 characters, compelling
  • Single H1 — One per page, describes main content
  • Logical heading hierarchy — H1 → H2 → H3 (no skipping)
  • Semantic HTML — <header>, <main>, <nav>, <article>, <footer>
  • Image alt text — Descriptive, not "image1.jpg"
Should Have (Marketing Pages)
  • Open Graph tags — og:title, og:description, og:image
  • Twitter Card — twitter:card, twitter:title
  • Canonical URL — Prevent duplicate content issues
  • Structured data — JSON-LD for rich snippets
Performance (Affects SEO)
  • Core Web Vitals awareness
    • LCP (Largest Contentful Paint) < 2.5s
    • FID (First Input Delay) < 100ms
    • CLS (Cumulative Layout Shift) < 0.1

Common Mistakes (Anti-Patterns)

1. Multiple H1 Tags
html
<!-- ❌ BAD: Multiple H1s confuse search engines -->
<h1>Welcome</h1>
<h1>Our Products</h1>
<h1>Contact Us</h1>

<!-- ✅ GOOD: One H1, logical hierarchy -->
<h1>Welcome to Our Store</h1>
<h2>Our Products</h2>
<h2>Contact Us</h2>
2. Missing Alt Text
html
<!-- ❌ BAD: Empty or useless alt -->
<img src="hero.jpg" alt="">
<img src="team.jpg" alt="image">

<!-- ✅ GOOD: Descriptive alt text -->
<img src="hero.jpg" alt="Software engineer working at laptop">
<img src="team.jpg" alt="Our founding team of 5 engineers">
3. Div Soup (No Semantic HTML)
html
<!-- ❌ BAD: No semantic meaning -->
<div class="header">
  <div class="nav">...</div>
</div>
<div class="content">...</div>
<div class="footer">...</div>

<!-- ✅ GOOD: Semantic HTML -->
<header>
  <nav>...</nav>
</header>
<main>...</main>
<footer>...</footer>
4. Skipping Heading Levels
html
<!-- ❌ BAD: Jumps from H1 to H4 -->
<h1>Page Title</h1>
<h4>Some Section</h4>

<!-- ✅ GOOD: Sequential hierarchy -->
<h1>Page Title</h1>
<h2>Main Section</h2>
<h3>Subsection</h3>
5. Generic Title Tags
html
<!-- ❌ BAD: Not descriptive -->
<title>Home</title>
<title>Page</title>

<!-- ✅ GOOD: Descriptive with keywords -->
<title>Daniel Lamb - Full Stack Developer Portfolio</title>
<title>Contact Us | Acme Software Solutions</title>

Socratic Questions

Ask these instead of giving answers:

  1. Title: "If someone sees this title in Google results, would they click it?"
  2. H1: "How many H1 tags does this page have? What happens if there are multiple?"
  3. Alt Text: "If the image doesn't load, what information is lost?"
  4. Semantic HTML: "Can a screen reader understand the structure of this page?"
  5. Meta Description: "Does this description make you want to click?"

Show full SKILL.md (145 more words)Show less

Stack-Specific Guidance

Next.js (App Router)
tsx
// Pattern: Metadata export
export const metadata = {
  title: 'Page Title',
  description: 'Page description',
  // Your implementation will differ
};
Next.js (Pages Router)
tsx
// Pattern: Next Head
import Head from 'next/head';

<Head>
  <title>Your title here</title>
  <meta name="description" content="Your description" />
</Head>
Plain HTML/React
html
<!-- In index.html or via react-helmet -->
<head>
  <title>Title here</title>
  <meta name="description" content="Description here">
</head>

Red Flags to Call Out

FlagQuestion
Missing title tag"What will this page show in search results?"
Multiple H1s"Which heading is the main topic? Search engines are confused."
No meta description"How will Google summarize this page?"
Empty alt text"What if the image doesn't load? What info is lost?"
All divs, no semantics"Can a screen reader navigate this page?"
Title over 60 chars"This will be cut off in search results. Can you shorten it?"

Open Graph Template

html
<!-- Minimum viable Open Graph -->
<meta property="og:title" content="Your Page Title">
<meta property="og:description" content="Your page description">
<meta property="og:image" content="https://yoursite.com/og-image.jpg">
<meta property="og:url" content="https://yoursite.com/page">
<meta property="og:type" content="website">

Interview Connection

"I implemented SEO best practices including semantic HTML, proper heading hierarchy, and meta tags, improving our page's discoverability."

When reviewing their code:

  • "What's your SEO strategy for this page?"
  • "How would Google understand what this page is about?"
  • "Show me your heading structure"

MCP Usage

Context7 - Framework Docs
Fetch: Next.js metadata documentation
Fetch: Semantic HTML best practices
Octocode - Real Examples
Search: "metadata" + "title" + "description" in Next.js repos
Search: Open Graph implementation patterns

© DanielPodolsky, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/fundamentals/seo of DanielPodolsky/ownyourcode.

Open the folder on GitHubat commit bd1f17c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in DanielPodolsky/ownyourcode, which our catalogue first saw on October 7, 2026.

Compare with similar skills

SEO Fundamentals next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Fundamentals compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Fundamentals this skillDanielPodolsky/ownyourcode2901 repos~1.4kAutomated safety check: PassMIT
SEOgridaco/grida2.7k—~2.1kAutomated safety check: PassApache-2.0
SEO PageAgriciDaniel/codex-seo7995 repos~1.2kAutomated safety check: PassMIT
Meta Tags OptimizerViryaZheng/recomby-geo4581 repos~2.7kAutomated safety check: PassMIT
Persian SEOTronIsHere/vibefarsiui212—~1.7kAutomated safety check: WarnMIT
Browser4 SEOplatonai/Browser41.2k—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • SEO

    gridaco/grida

    SEO best practices for the Grida project across Next.js pages, blog posts, and documentation.

    2.7k GitHub stars~2.1k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • SEO Page

    AgriciDaniel/codex-seo

    Deep single-page SEO analysis covering on-page elements, content quality, technical meta tags, schema, images, and performance.

    799 GitHub starsUsed in 5 repos~1.2k tokens
    Marketing & SEOAuto-check passed
  • Meta Tags Optimizer

    ViryaZheng/recomby-geo

    Optimize title tags, meta descriptions, Open Graph, and Twitter cards for maximum click-through rate.

    458 GitHub starsUsed in 1 repo~2.7k tokens
    Marketing & SEOAuto-check passed
  • Persian SEO

    TronIsHere/vibefarsiui

    Technical and on-page SEO for Persian (Farsi) websites: lang and hreflang for fa-IR, RTL-safe metadata, Persian titles and descriptions, slug and URL strategy for Persian content, ZWNJ and keyword…

    212 GitHub stars~1.7k tokensUpdated yesterday
    Marketing & SEOAuto-check: warnings
  • Browser4 SEO

    platonai/Browser4

    Extract and audit SEO metadata from the current browser page.

    1.2k GitHub stars~1.6k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Blog SEO Check

    AgriciDaniel/claude-blog

    Post-writing SEO validation with pass/fail checklist covering title tag length and keyword placement, meta description quality, heading hierarchy and keyword density, internal/external link audit…

    2.3k GitHub stars~2.7k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from DanielPodolsky/ownyourcode

All 19 skills in this repo
  • Accessibility Fundamentals

    DanielPodolsky/ownyourcode

    Reviews accessibility including WCAG, ARIA, keyboard navigation.

    290 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Backend Fundamentals

    DanielPodolsky/ownyourcode

    Reviews API design, REST conventions, and backend architecture.

    290 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Database Fundamentals

    DanielPodolsky/ownyourcode

    Reviews schema design, SQL queries, ORM patterns. An agent skill from DanielPodolsky/ownyourcode.

    290 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Documentation Fundamentals

    DanielPodolsky/ownyourcode

    Guides documentation standards including READMEs, JSDoc, and code comments.

    290 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Error Handling Fundamentals

    DanielPodolsky/ownyourcode

    Guides error handling for async operations and API calls. An agent skill from DanielPodolsky/ownyourcode.

    290 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Frontend Fundamentals

    DanielPodolsky/ownyourcode

    Reviews React/Vue component architecture, state, and hooks. An agent skill from DanielPodolsky/ownyourcode.

    290 GitHub starsUsed in 1 repo~874 tokens
    Auto-check passed

Categories

Questions about SEO Fundamentals

What does SEO Fundamentals do?

Reviews SEO including meta tags, semantic HTML, and Open Graph. SEO Fundamentals is an agent skill from DanielPodolsky/ownyourcode. Reviews SEO including meta tags, semantic HTML, and Open Graph.

When should I use SEO Fundamentals?

SEO Fundamentals fits situations like: building public-facing pages; adding title/description tags; optimizing for search engines.

How do I install SEO Fundamentals in Claude Code?

Run `npx skills add DanielPodolsky/ownyourcode --skill seo-fundamentals -a claude-code`. Or copy the skill folder (.claude/skills/fundamentals/seo in DanielPodolsky/ownyourcode) into .claude/skills/seo-fundamentals in your project. Claude Code loads it when a task matches its description.

How do I install SEO Fundamentals in Codex?

Run `npx skills add DanielPodolsky/ownyourcode --skill seo-fundamentals -a codex`. Or copy the skill folder (.claude/skills/fundamentals/seo in DanielPodolsky/ownyourcode) into .agents/skills/seo-fundamentals in your project. Codex loads it when a task matches its description.

Can I use SEO Fundamentals in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add DanielPodolsky/ownyourcode --skill seo-fundamentals -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-fundamentals, .gemini/skills/seo-fundamentals, .github/skills/seo-fundamentals and .opencode/skills/seo-fundamentals in your project.

What does SEO Fundamentals need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Fundamentals is instructions for the agent only.

Does SEO Fundamentals access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Fundamentals safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Fundamentals use?

SEO Fundamentals is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Fundamentals use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Fundamentals?

Skills that share tags, products or a category with SEO Fundamentals: SEO (gridaco/grida, 2.7k stars), SEO Page (AgriciDaniel/codex-seo, 799 stars), Meta Tags Optimizer (ViryaZheng/recomby-geo, 458 stars) and Persian SEO (TronIsHere/vibefarsiui, 212 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Fundamentals?

DanielPodolsky (a GitHub user) maintains it in DanielPodolsky/ownyourcode, which has 290 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on June 27, 2026.

Source: DanielPodolsky/ownyourcode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.