upgradeseo: Skill for Claude Code

.agents/skills/seo-project-setup/SKILL.md

seo-project-setup is a skill for Claude Code, Codex from upgrade-ventures/upgradeseo. It costs 33 tokens per session (1,398 once invoked), scanned A, a copy of seo-project-setup, MIT.

A setup workflow for keeping one website's search-engine optimisation work in an organised local folder. SEO means improving a website so it can appear more usefully in search results.

In plain words
What is it for?
Use it to start an SEO project, record the site's goals and positioning, organise research and reports, check available data connections, and bring in Google Search Console data.
Why use it?
It prevents project goals, notes, reports, keyword data, and Search Console exports from being scattered across different places. It also gives future work a consistent source of context.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is upgrade-ventures/upgradeseo's own configuration. It tells Claude Code and Codex how to work on upgradeseo itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything upgradeseo configures →

Reuse

Borrowing it

Nothing to install: this file belongs to upgrade-ventures/upgradeseo. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/upgrade-ventures/upgradeseo/main/.agents/skills/seo-project-setup/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/upgrade-ventures/upgradeseo

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for seo-project-setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/upgrade-ventures/upgradeseo/seo-project-setup.svg)](https://agentmods.dev/skills/upgrade-ventures/upgradeseo/seo-project-setup)
Your own site
<a href="https://agentmods.dev/skills/upgrade-ventures/upgradeseo/seo-project-setup"><img src="https://agentmods.dev/badge/skills/upgrade-ventures/upgradeseo/seo-project-setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,398 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 94% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00033 $0.01398
Opus 5 $0.00016 $0.00699
Sonnet 5 $0.00007 $0.00280
Haiku 4.5 $0.00003 $0.00140

Measured 7d ago against content hash 6c77dd81e8e4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

seo-project-setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

94% identical to seo-project-setup — 12 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/skills/seo-project-setup/SKILL.md · 167 lines

How it starts

The opening of the file, as written. The whole thing — 167 lines — stays where its author put it; the contents beside it link to each section on GitHub.

UpgradeSEO SEO Project Setup

Goal

Help the user set up a local SEO workspace for one website or SEO project. The folder is where the agent saves notes, goals, exports, briefs, reports, preferences, and project context over time. This is a workspace and context setup workflow, not a full audit.

Tone

Be friendly, practical, and structured. Ask questions in small batches. Explain why each item matters only when useful. Do not overwhelm a beginner with jargon.

Checklist

1. Pick a working folder

Suggest that the user choose or create a local folder for SEO work, for example:

  • ~/SEO/<company-or-site>/
  • ~/Documents/SEO/<company-or-site>/
  • A repo or workspace folder if SEO work should live beside website/content files

Explain that keeping notes, exports, briefs, scraped pages, reports, and preferences in one folder helps the agent build context over time. Future SEO workflows can use that folder rather than starting from a blank conversation.

Recommended starter structure:

seo-workspace/
  README.md
  gsc/
  keywords/
  competitors/
  content/
  outreach/
  reports/

Do not create folders unless the user asks. If file tools are available and the user asks, create a simple structure and a short README.md with the current goals, known sites, and user preferences for how the agent should approach SEO for this project.

2. Collect website scope

Ask for:

  • Primary website/domain
  • Additional domains or subdomains
  • Important products, services, categories, or pages
  • Target countries/languages
  • Whether the site is new, established, migrating, or recovering from a drop
  • CMS or publishing workflow, if relevant

3. Capture goals

Ask the user what they want from SEO:

  • More qualified leads
  • More signups/trials
  • More ecommerce revenue
  • More newsletter/audience growth
  • More brand/category awareness
  • Recovery from traffic loss
  • Better ranking for specific pages

Ask for success metrics and timeframe. If goals are vague, help turn them into measurable goals such as "increase non-branded organic signups" or "rank top 10 for 20 buying-intent terms."

Read the full file on GitHub · 167 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 167 lines · 33 tokens per session scan A 6c77dd81e8e4

Subscribe to this mod's changes

seo-project-setup is a skill published in the GitHub repository upgrade-ventures/upgradeseo (1 stars, last pushed 20d ago), licensed MIT. It adds 33 tokens to every session and 1,398 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 94% identical to seo-project-setup, differing in 12 lines, and is treated as a copy.

Related

Other skills, from other repositories

semrush-backlink-audit

Audit backlink profiles with the semrush CLI. Use when the user asks for backlink analysis, referring domains, authority score, anchor text, indexed linked pages, backlink competitors, link gaps, backlink history, toxic or suspicious link signals, or off-page SEO recommendations based on Semrush CLI backlink data.

osodevops/intelligence-layer-skills · 66 tokens

semrush-cli-setup

Install, configure, validate, and troubleshoot the semrush CLI. Use when the user needs Semrush API auth, SEMRUSHAPIKEY or SEMRUSHOAUTHTOKEN setup, output/cache/rate-limit configuration, shell completions, API balance checks, structured error handling, or a prerequisite check before running other Semrush CLI skills.

osodevops/intelligence-layer-skills · 74 tokens

semrush-competitor-research

Analyze SEO competitors, organic keywords, top pages, subdomains, and keyword gaps with the semrush CLI. Use when the user asks for competitor research, organic competitor discovery, content gaps, domain comparison, missing or untapped keywords, page-level SEO opportunities, or a competitive SEO audit using Semrush…

osodevops/intelligence-layer-skills · 71 tokens

semrush-keyword-research

Research, expand, score, and prioritize SEO keywords with the semrush CLI. Use when the user asks for keyword research, search volume, CPC, difficulty, related keywords, broad-match keywords, question keywords, keyword clustering inputs, SERP domains for a query, or a prioritized keyword opportunity table powered by…

osodevops/intelligence-layer-skills · 73 tokens

semrush-batch-workflows

Create, estimate, run, and adapt semrush CLI TOML batch recipes. Use when the user needs reusable Semrush CLI workflows, competitor audit recipes, keyword opportunity recipes, backlink audit recipes, paid-search recipes, traffic summary recipes, scheduled SEO data pulls, or API-unit estimates before multi-step Semrush…

osodevops/intelligence-layer-skills · 70 tokens

semrush-local-seo

Manage and analyze local SEO data with semrush CLI v4 commands. Use when the user asks for Semrush local listings, local business location records, Google Maps or map-rank campaigns, map-rank keywords, heatmaps, local competitors, NAP/listing QA, or local SEO reporting through the Semrush CLI.

osodevops/intelligence-layer-skills · 71 tokens