Agent skill

SEO Technical

by shawnpang in shawnpang/startup-founder-skills

When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings.

MITAuto-check passedMarketing & SEO

Install SEO Technical

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill seo-technical -a claude-code

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

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills seo-technical --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/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-technical .claude/skills/seo-technical && 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-technical
GitHub stars
342
Token cost
~2.1k tokens
SKILL.md length
1,086 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings.

  • Works in 9 steps: Crawlability audit — Foundation; nothing… → Indexation audit — Ensure crawled pages… → Security and HTTPS — HTTPS is a ranking… → …
  • Needs a technical SEO audit
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Technical is an agent skill from shawnpang/startup-founder-skills. When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings.

Its SKILL.md is about 2.1k 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 Technical SEO. It works with Google Search Console. The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Needs a technical SEO audit
  • On-page optimization guidance
  • Help resolving crawlability
  • Performance issues that affect search rankings

Example prompts

  • “/seo-technical”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Crawlability audit — Foundation; nothing else matters if search engines cannot crawl the site.
  2. Indexation audit — Ensure crawled pages are actually indexed.
  3. Security and HTTPS — HTTPS is a ranking signal and a trust requirement.
  4. URL structure — Short, descriptive, hyphenated URLs without parameters.
  5. Mobile optimization — As of July 2024, Google crawls and indexes ALL websites exclusively with the mobile Googlebot user-agent…
  6. Core Web Vitals — Google uses these as ranking signals. Current targets
  7. Structured data — Implement schema markup for rich results.
  8. JavaScript rendering — Critical for SPAs and JS-heavy sites.
  9. AI crawler management — Managing AI crawlers via robots.txt is a critical 2025-2026 consideration.

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. 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.

    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 Technical loads about 2.1k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 1,086 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
~2.1k

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 shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 1,086 words, ~2,066 tokens.

Download SKILL.mdSave it as .claude/skills/seo-technical/SKILL.md (or your agent's skills folder).
name
seo-technical
description
When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings.
related
content-strategy, landing-page
reads
startup-context

SEO Technical

When to Use

  • Running a technical SEO audit on an existing site.
  • Diagnosing why pages are not being indexed or ranked.
  • Optimizing Core Web Vitals or page speed.
  • Setting up site architecture (sitemaps, robots.txt, canonicalization).
  • Implementing structured data / schema markup.
  • Managing AI crawler access via robots.txt.
  • Preparing a new site or migration for SEO readiness.
  • Reviewing JavaScript rendering and its impact on indexation.

Context Required

  • From startup-context: product description, target audience, primary keywords, current domain and site structure.
  • From the user: site URL, access to Google Search Console data (if available), specific pages of concern, known issues, tech stack (static site, SPA, WordPress, etc.), whether the site has been previously audited.

Workflow

Audit across 9 technical dimensions. Score on a 100-point scale with category breakdowns.

  1. Crawlability audit — Foundation; nothing else matters if search engines cannot crawl the site.
    • Check robots.txt for unintended disallow rules.
    • Verify XML sitemap exists, is submitted to Search Console, and is up to date.
    • Identify crawl errors (4xx, 5xx status codes).
    • Check for orphan pages (no internal links pointing to them).
    • Audit redirect chains — flatten to single hops. Chains of 3+ waste crawl budget and dilute link equity.
    • For sites with 10,000+ pages, analyze crawl budget efficiency and remove low-value pages from the index.
  2. Indexation audit — Ensure crawled pages are actually indexed.
    • Check site:domain.com results vs. expected page count.
    • Look for noindex tags applied unintentionally.
    • Identify duplicate content issues and missing canonical tags.
    • Check for thin content pages that may be filtered out.
    • Review index coverage report in Search Console for excluded pages.
  3. Security and HTTPS — HTTPS is a ranking signal and a trust requirement.
    • Verify HTTPS everywhere with proper redirects from HTTP.
    • Check for mixed content issues.
    • Validate SSL certificate and HSTS headers.
  4. URL structure — Short, descriptive, hyphenated URLs without parameters.
    • Consistent URL patterns across the site.
    • No duplicate content from URL variations (trailing slashes, www vs. non-www).
    • Self-referencing canonical tags on every page.
  5. Mobile optimization — As of July 2024, Google crawls and indexes ALL websites exclusively with the mobile Googlebot user-agent. Mobile-first is not optional.
    • Mobile and desktop content parity is mandatory.
    • Test with mobile-friendly tools.
    • Responsive design, no horizontal scroll, touch targets properly sized.
  6. Core Web Vitals — Google uses these as ranking signals. Current targets:
    • LCP (Largest Contentful Paint): Target under 2.5 seconds. Fixes: optimize hero images, implement lazy loading, use CDN, reduce server response time.
    • INP (Interaction to Next Paint): Target under 200ms. INP replaced FID in March 2024. Fixes: reduce JavaScript execution time, break up long tasks, optimize event handlers.
    • CLS (Cumulative Layout Shift): Target under 0.1. Fixes: set explicit dimensions on images/embeds, avoid injecting content above existing content, use font-display: swap.
    • Check for render-blocking CSS/JS, unoptimized images, excessive third-party scripts.
  7. Structured data — Implement schema markup for rich results.
    • Organization schema on the homepage.
    • Article/BlogPosting schema on content pages.
    • Product schema on product pages.
    • FAQ schema where applicable (boosts SERP real estate).
    • BreadcrumbList schema for navigation clarity.
    • Validate with Google's Rich Results Test.
  8. JavaScript rendering — Critical for SPAs and JS-heavy sites.
    • Serve canonical tags, robots directives, and structured data in initial server-rendered HTML. Google may not reliably process these if injected via JavaScript.
    • Verify server-side rendering or pre-rendering is in place for critical content.
    • Test what Googlebot actually sees vs. what users see.
  9. AI crawler management — Managing AI crawlers via robots.txt is a critical 2025-2026 consideration.
    • GPTBot (OpenAI), ClaudeBot (Anthropic), PerplexityBot, Bytespider (ByteDance), Google-Extended
    • Blocking Google-Extended does NOT affect Google Search indexing or AI Overviews — only Gemini training data.
    • Decide per-crawler based on business needs: allow, block, or rate-limit.

Output Format

A prioritized audit report scored on a 100-point scale:

  • Critical issues (blocking indexation or causing major ranking loss): fix immediately
  • High-impact improvements (will meaningfully improve rankings): fix within 2 weeks
  • Medium improvements (incremental gains): fix within 30 days
  • Low priority (minor optimizations): address when convenient

Each item includes: the issue, why it matters for rankings, how to fix it, and estimated effort (low/medium/high).

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

Frameworks & Best Practices

  • Canonical tags are directives, not suggestions: While Google treats them as hints, properly implemented canonicals are followed in the vast majority of cases. Always self-canonical pages and canonical duplicates to the preferred version.
  • JavaScript SEO: Critical metadata (canonical, robots, structured data) must be in initial server-rendered HTML. Google can render JS but with delays and reliability gaps.
  • Mobile-first is complete: Since July 2024, there is no "desktop index." The mobile version IS the version Google indexes. Full content parity is non-negotiable.
  • INP replaced FID: FID was fully removed from Chrome tools by September 2024. All performance optimization should target INP (under 200ms), not FID.
  • Crawl budget: Rarely an issue for sites under 10,000 pages. For larger sites, prioritize by removing low-value pages and fixing redirect chains.
  • Hreflang for international sites: Implement correctly or not at all. Errors cause worse indexation than no hreflang tags.
  • Log file analysis: Server logs reveal what Googlebot actually crawls vs. what you want crawled. This is the ground truth of crawlability.
  • Speed is a tiebreaker: Rarely causes dramatic ranking changes alone, but affects user behavior metrics (bounce rate, time on site) which indirectly impact rankings.
  • E-E-A-T signals matter: Author bios with credentials, about page, contact info, links to authoritative sources, HTTPS, privacy policy, terms of service.
  • content-strategy — when the audit reveals content gaps or thin content that needs a broader content plan
  • landing-page — when key landing pages need both CRO and on-page SEO optimization

Examples

Example 1: Full audit

"We launched our site 6 months ago and we're barely showing up in Google. Can you audit our SEO?"

Good output: A structured audit across all 9 dimensions with a 100-point score. Identifies that robots.txt is blocking the /blog/ directory, sitemap is missing, several pages have duplicate title tags, Core Web Vitals are failing on mobile (LCP at 4.2s due to unoptimized hero image), canonical tags and structured data are injected via JavaScript instead of server-rendered HTML, and no AI crawler policy is defined. Prioritized fix list with critical, high, medium, and low items with effort estimates.

Example 2: Specific issue

"Our blog posts were ranking well but traffic dropped 40% last month."

Good output: Diagnostic checklist starting with Search Console data review (manual actions, crawl errors, index coverage changes), then checking for algorithm update timing, content cannibalization between similar posts, accidental noindex or broken canonicals, Core Web Vitals regression (especially INP after a JS-heavy deploy), lost backlinks, and mobile rendering issues. Recommends specific data to gather and steps to isolate the cause.

© shawnpang, 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 skills/seo-technical of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

SEO Technical 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 Technical compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Technical this skillshawnpang/startup-founder-skills342—~2.1kAutomated safety check: PassMIT
Google SEO APIsAgriciDaniel/claude-seo19k1 repos~4.2kAutomated safety check: PassMIT
Qiaomu SEOjoeseesun/qiaomu-seo441—~2.6kAutomated safety check: PassMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
SEO Setupalisamadiii/Portfolio180—~1.7kAutomated safety check: PassNone
SEO Auditfreekmurze/dotfiles1k34 repos~2.2kAutomated safety check: PassNone

Similar skills

  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • Qiaomu SEO

    joeseesun/qiaomu-seo

    Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.

    441 GitHub stars~2.6k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • SEO Coach

    akseolabs-seo/seo-coach

    Beginner-first SEO coaching for people who want to learn by doing one safe, verifiable step at a time.

    146 GitHub stars~2.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • SEO Setup

    alisamadiii/Portfolio

    Full SEO/metadata setup and audit for client websites (Astro, Next.js, any static site).

    180 GitHub stars~1.7k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    freekmurze/dotfiles

    When the user wants to audit, review, or diagnose SEO issues on their site.

    1k GitHub starsUsed in 34 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • Google Search SEO Guide

    littleben/awesomeAgentskills

    Answers Google Search optimization questions from reference files covering crawling, indexing, structured data, Search Console and site visibility, drawn from Google's documentation.

    188 GitHub starsUsed in 2 repos~4.2k tokens
    Marketing & SEOAuto-check passed

More from shawnpang/startup-founder-skills

All 50 skills in this repo
  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    342 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    342 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    342 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Churn Analysis

    shawnpang/startup-founder-skills

    When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

    342 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    342 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    342 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about SEO Technical

What does SEO Technical do?

When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings. SEO Technical is an agent skill from shawnpang/startup-founder-skills. When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings.

When should I use SEO Technical?

SEO Technical fits situations like: needs a technical SEO audit; on-page optimization guidance; help resolving crawlability; performance issues that affect search rankings.

How do I install SEO Technical in Claude Code?

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

How do I install SEO Technical in Codex?

Run `npx skills add shawnpang/startup-founder-skills --skill seo-technical -a codex`. Or copy the skill folder (skills/seo-technical in shawnpang/startup-founder-skills) into .agents/skills/seo-technical in your project. Codex loads it when a task matches its description.

Can I use SEO Technical 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 shawnpang/startup-founder-skills --skill seo-technical -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-technical, .gemini/skills/seo-technical, .github/skills/seo-technical and .opencode/skills/seo-technical in your project.

What does SEO Technical need to run?

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

Does SEO Technical 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 Technical 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 Technical use?

SEO Technical 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 Technical use?

About 2.1k tokens (SKILL.md is roughly 8.3k 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 Technical?

Skills that share tags, products or a category with SEO Technical: Google SEO APIs (AgriciDaniel/claude-seo, 19k stars), Qiaomu SEO (joeseesun/qiaomu-seo, 441 stars), SEO Coach (akseolabs-seo/seo-coach, 146 stars) and SEO Setup (alisamadiii/Portfolio, 180 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Technical?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 342 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.