Agent skill

Gsc Portfolio Audit

by OpenClaudia in OpenClaudia/openclaudia-skills

Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

MITAuto-check passedMarketing & SEO

Install Gsc Portfolio Audit

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill gsc-portfolio-audit -a claude-code

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

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills gsc-portfolio-audit --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/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gsc-portfolio-audit .claude/skills/gsc-portfolio-audit && 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
gsc-portfolio-audit
GitHub stars
713
Token cost
~1k tokens
SKILL.md length
423 words
Files
2 (incl. scripts)
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

  • Asked to compare all sites
  • SKILL.md covers Setup, Run it, Sections and what they mean and Interpreting, plus 1 more section
  • Runs Python scripts from its folder; calls python3 and pip; reaches googleapis.com; needs GOOGLE_GSC_CLIENT_SECRET and GOOGLE_CLIENT_SECRET
  • Rank properties by traffic

What it does

Gsc Portfolio Audit is an agent skill from OpenClaudia/openclaudia-skills. Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising, dropping, lost, or ranking well without earning clicks. Built for agencies and multi-site owners. Use when asked to compare all sites, rank properties by traffic, find new keywords across a portfolio, or spot which site is down. Trigger phrases: "audit GSC", "all my sites", "rank my properties", "portfolio search…

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/audit_gsc.py`).

It sits in Marketing & SEO. It works with Google Search Console. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • Asked to compare all sites
  • Rank properties by traffic
  • Find new keywords across a portfolio
  • Spot which site is down

Example prompts

  • “audit GSC”
  • “all my sites”
  • “rank my properties”
  • “/gsc-portfolio-audit”

Requirements

  • Python 3
  • A credential in GOOGLE_GSC_CLIENT_SECRET
  • A credential in GOOGLE_CLIENT_SECRET

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • pip

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • googleapis.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOGLE_GSC_CLIENT_SECRET
    • GOOGLE_CLIENT_SECRET
    • GOOGLE_REFRESH_TOKEN

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

Context cost

Gsc Portfolio Audit loads about 1k tokens when it runs. Until then it costs about 188 tokens; SKILL.md has 423 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~188
When it runs · the whole SKILL.md, loaded when a task matches
~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); the scripts in this folder are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit ad0d1e5, republished under its MIT licence (© OpenClaudia). 423 words, ~1,042 tokens.

Download SKILL.mdSave it as .claude/skills/gsc-portfolio-audit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
gsc-portfolio-audit
description
Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising, dropping, lost, or ranking well without earning clicks. Built for agencies and multi-site owners. Use when asked to compare all sites, rank properties by traffic, find new keywords across a portfolio, or spot which site is down. Trigger phrases: "audit GSC", "all my sites", "rank my properties", "portfolio search performance", "which sites are down", "what new keywords are we ranking for", "client site performance", "GSC report across accounts". For ONE site's queries, pages, or index coverage, use the search-console skill instead.

GSC Portfolio Audit

Answers "how is everything doing?" across every property on a Search Console account, which is the question the per-site tooling can't answer without dozens of manual exports.

Setup

Requires an OAuth refresh token with https://www.googleapis.com/auth/webmasters.readonly:

bash
export GOOGLE_GSC_CLIENT_ID=...      # or GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=...  # or GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com"   # optional, comma-separated
pip install requests

The most common setup failure is unauthorized_client on token refresh. It means the refresh token was issued for a different OAuth client than the id/secret you paired with it. Accounts that have added Google integrations over time usually have several clients; match the pair that minted the token.

Run it

bash
python3 scripts/audit_gsc.py            # full: ranking + keyword diff for the top 12
python3 scripts/audit_gsc.py portfolio  # just the ranked table
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90  # quarter over quarter

Flags: --days (window, compared against the window immediately before it), --site (repeatable), --top, --limit, --min-clicks.

Sections and what they mean

SectionRead it as
NEWqueries with zero clicks last period. Where growth is actually coming from.
RISINGup ≥50%. Check whether position moved too — if it didn't, demand rose, not your ranking.
DROPPINGdown ≥40% off a real base. Position tells you which kind: rank fell = ranking loss; rank held but clicks collapsed = something took the clicks above you (AI Overview, a new SERP feature, or the query changed shape).
LOSTranked before, no data now.
CTR GAP≥1,500 impressions, top 10, under 2% CTR. Title and description rewrites, the cheapest wins available.
Show full SKILL.md (221 more words)Show less

Interpreting

  • Report clicks first, impressions second. One large property can swing portfolio impressions enough to mask that everything else grew.
  • Separate brand from non-brand. A site whose entire keyword set is its own name (or misspellings of a competitor's) has no acquisition engine, however good the click count looks. Say so plainly in the report.
  • A whole-site collapse on its own head term is usually not SEO. Check ownership before diagnosing rankings: whois <domain> | grep -i "registrar\|updated date" plus whether it still resolves. Expired, transferred, or disputed domains produce a textbook ranking cliff that no amount of SEO work will fix.
  • "new" in the portfolio table means zero clicks in the prior window, which for a recently launched site is a launch, not a data gap.
  • Don't skip queries in languages you can't read. On multi-market sites the growth is usually in non-English long tail; translate the interesting ones rather than filtering them out.
  • A property returning 403 is verified for listing but not for search analytics. The script reports it instead of hiding it.

Notes

  • GSC data lags about 3 days; the script offsets for this automatically.
  • Both periods are fetched per property in parallel, so a 40-property account takes seconds.
  • Query rows are capped at 25,000 per period, well above what any single site returns for a 28-day window.

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

Files

SKILL.md and 1 other file (scripts) in skills/gsc-portfolio-audit of OpenClaudia/openclaudia-skills.

  • SKILL.md
  • scripts/audit_gsc.py

Open the folder on GitHubat commit ad0d1e5

Compare with similar skills

Gsc Portfolio Audit 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.

Gsc Portfolio Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gsc Portfolio Audit this skillOpenClaudia/openclaudia-skills713—~1kAutomated safety check: PassMIT
Google SEO APIsAgriciDaniel/claude-seo19k1 repos~4.2kAutomated safety check: PassMIT
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT
SEO GodAKCodez/seo-god113—~2.2kAutomated safety check: PassMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
SEO Setupalisamadiii/Portfolio180—~1.7kAutomated 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
  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check: notes
  • SEO God

    AKCodez/seo-god

    Agentic SEO operator for your own website: audits and fixes your site with OpenSEO, measures rankings + Google Search Console, works to get ChatGPT and other AI engines citing you, and schedules the…

    113 GitHub stars~2.2k 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 4 days ago
    Marketing & SEOAuto-check passed
  • SEO Coach

    petera2c/simple-table

    Enter a friendly OpenSEO coach mode that explains workflows, recommends next steps, and helps users use agents, web search, scraping, and MCP data effectively.

    229 GitHub starsUsed in 2 repos~1.2k tokens
    Marketing & SEOAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    713 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated today
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    713 GitHub stars~882 tokensUpdated today
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    713 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Affiliate Marketing

    OpenClaudia/openclaudia-skills

    Build and manage an affiliate marketing program. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Gsc Portfolio Audit

What does Gsc Portfolio Audit do?

Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…. Gsc Portfolio Audit is an agent skill from OpenClaudia/openclaudia-skills. Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising, dropping, lost, or ranking well without earning clicks.

When should I use Gsc Portfolio Audit?

Gsc Portfolio Audit fits situations like: asked to compare all sites; rank properties by traffic; find new keywords across a portfolio; spot which site is down.

How do I install Gsc Portfolio Audit in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill gsc-portfolio-audit -a claude-code`. Or copy the skill folder (skills/gsc-portfolio-audit in OpenClaudia/openclaudia-skills) into .claude/skills/gsc-portfolio-audit in your project. Claude Code loads it when a task matches its description.

How do I install Gsc Portfolio Audit in Codex?

Run `npx skills add OpenClaudia/openclaudia-skills --skill gsc-portfolio-audit -a codex`. Or copy the skill folder (skills/gsc-portfolio-audit in OpenClaudia/openclaudia-skills) into .agents/skills/gsc-portfolio-audit in your project. Codex loads it when a task matches its description.

Can I use Gsc Portfolio Audit 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 OpenClaudia/openclaudia-skills --skill gsc-portfolio-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gsc-portfolio-audit, .gemini/skills/gsc-portfolio-audit, .github/skills/gsc-portfolio-audit and .opencode/skills/gsc-portfolio-audit in your project.

What does Gsc Portfolio Audit need to run?

Going by SKILL.md and its folder, Gsc Portfolio Audit needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and pip) and credentials named GOOGLE_GSC_CLIENT_SECRET, GOOGLE_CLIENT_SECRET and GOOGLE_REFRESH_TOKEN. Our summary lists: Python 3; A credential in GOOGLE_GSC_CLIENT_SECRET; A credential in GOOGLE_CLIENT_SECRET.

Does Gsc Portfolio Audit access the network?

SKILL.md names 1 domain. In commands or code: googleapis.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Gsc Portfolio Audit 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Gsc Portfolio Audit use?

Gsc Portfolio Audit 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 Gsc Portfolio Audit use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Gsc Portfolio Audit?

Skills that share tags, products or a category with Gsc Portfolio Audit: Google SEO APIs (AgriciDaniel/claude-seo, 19k stars), Blog Google (AgriciDaniel/claude-blog, 2.3k stars), SEO God (AKCodez/seo-god, 113 stars) and SEO Coach (akseolabs-seo/seo-coach, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gsc Portfolio Audit?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on October 11, 2026.

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