Agent skill

SEO Unlighthouse

by AgriciDaniel in AgriciDaniel/claude-seo

Multi-page Lighthouse audit via the MIT-licensed Unlighthouse CLI.

MITAuto-check passedFrontend & Design

Install SEO Unlighthouse

skills CLI
$ npx skills add AgriciDaniel/claude-seo --skill seo-unlighthouse -a claude-code

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

GitHub CLI
$ gh skill install AgriciDaniel/claude-seo seo-unlighthouse --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/AgriciDaniel/claude-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/extensions/unlighthouse/skills/seo-unlighthouse .claude/skills/seo-unlighthouse && 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-unlighthouse
GitHub stars
19k
Token cost
~617 tokens
SKILL.md length
254 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Multi-page Lighthouse audit via the MIT-licensed Unlighthouse CLI.

  • Tasks that involve Web performance
  • SKILL.md covers Prerequisites, Routing, Output handling and Cross-skill delegation
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Unlighthouse is an agent skill from AgriciDaniel/claude-seo. Multi-page Lighthouse audit via the MIT-licensed Unlighthouse CLI. Free-tier alternative to running PageSpeed against every URL on a site, no API quota burn, runs locally.

Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires Node 18+ and the unlighthouse npm package. Run extensions/unlighthouse/install.sh to pre-warm.

It sits in Frontend & Design, covering Web performance. The repository describes itself as: Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP… The licence is MIT.

When your agent uses it

  • Tasks that involve Web performance

Example prompts

  • “/seo-unlighthouse”

Requirements

  • Compatibility (from SKILL.md): Requires Node 18+ and the unlighthouse npm package. Run extensions/unlighthouse/install.sh to pre-warm.

What it can do on your machine

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

  • Compatibility

    Requires Node 18+ and the unlighthouse npm package. Run extensions/unlighthouse/install.sh to pre-warm.

    From compatibility in the SKILL.md frontmatter.

Context cost

SEO Unlighthouse loads about 617 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 254 words of instructions outside code blocks.

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

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 AgriciDaniel/claude-seo at commit 4b99de2, republished under its MIT licence (© AgriciDaniel). 254 words, ~617 tokens.

Download SKILL.mdSave it as .claude/skills/seo-unlighthouse/SKILL.md (or your agent's skills folder).
name
seo-unlighthouse
description
Multi-page Lighthouse audit via the MIT-licensed Unlighthouse CLI. Free-tier alternative to running PageSpeed against every URL on a site, no API quota burn, runs locally.
compatibility
Requires Node 18+ and the unlighthouse npm package. Run extensions/unlighthouse/install.sh to pre-warm.
metadata.version
2.4.2

seo-unlighthouse

Run Lighthouse against every URL on a site (up to a configurable cap) and aggregate the results. Useful when:

  • PageSpeed Insights' free quota (25k QPD) isn't enough for a large site.
  • You want offline / local CWV measurement (CI integration, restricted environments).
  • You need a quick site-wide regression check after a deploy.

Prerequisites

  • Run extensions/unlighthouse/install.sh (no API key needed).
  • Node 18+ on $PATH.

Routing

CommandEffect
/seo unlighthouse <url>Mobile audit, up to 200 routes, JSON+HTML report in a temp dir
/seo unlighthouse <url> --device desktopDesktop form factor
/seo unlighthouse <url> --max-routes 50 --output-dir ./reportsCap + persist

All flags forward through "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run unlighthouse_run.py, which handles url_safety pre-flight and subprocess timeout management.

Output handling

The wrapper reads ci-result.json from the Unlighthouse output dir, normalizes it (the default jsonSimple reporter writes a flat JSON array of per-route results; a tolerant fallback also accepts the jsonExpanded object shape), and returns:

  • route_count: number of routes actually audited
  • aggregate_scores: median score per Lighthouse category across all audited routes (performance, accessibility, best-practices, seo)
  • routes: the per-route breakdown (also on disk at <output_dir>/ci-result.json)

Route cap and per-page timeout are set via a generated unlighthouse.config.mjs passed with --config-file (the only CLI-documented way to set scanner.maxRoutes; unlighthouse-ci has no --max-routes flag). Use --page-timeout <seconds> to change the per-page Lighthouse task timeout (default 60s); this is separate from the overall --timeout subprocess guard (default 600s).

Cross-skill delegation

  • For single-URL field data (CrUX), use seo-google psi / seo-google crux.
  • For LCP subpart decomposition on slow pages, use the "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run lcp_subparts.py workflow (Phase C).

© AgriciDaniel, 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 extensions/unlighthouse/skills/seo-unlighthouse of AgriciDaniel/claude-seo.

Open the folder on GitHubat commit 4b99de2

Compare with similar skills

SEO Unlighthouse 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 Unlighthouse compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Unlighthouse this skillAgriciDaniel/claude-seo19k—~617Automated safety check: PassMIT
SEO GoogleAgriciDaniel/codex-seo7992 repos~3.4kAutomated safety check: PassMIT
Landing CraftEliasOulkadi/shokunin114—~4.5kAutomated safety check: PassMIT
Ship Checktextura-agency/next16-claude-starter133—~1.5kAutomated safety check: NotesUnlicense
SEO PerformanceAgriciDaniel/codex-seo799—~733Automated safety check: PassCustom licence
SEO FundamentalsxenitV1/Antigravity-Workflows1302 repos~696Automated safety check: PassMIT

Similar skills

  • SEO Google

    AgriciDaniel/codex-seo

    Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic.

    799 GitHub starsUsed in 2 repos~3.4k tokens
    Frontend & DesignAuto-check passed
  • Landing Craft

    EliasOulkadi/shokunin

    Build conversion-optimized landing pages with CRO frameworks (Conversion Research, LIFT Model), scroll effects, A/B testing, personalization, form optimization, and Core Web Vitals (INP, LCP, CLS).

    114 GitHub stars~4.5k tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • Ship Check

    textura-agency/next16-claude-starter

    Pre-launch gate for this starter — build, mechanical rule checks, SEO, metadata and brand-kit completeness, the robot form, measured load (Lighthouse people + robot) and scroll (PC + phone)…

    133 GitHub stars~1.5k tokensUpdated 3 days ago
    Frontend & DesignAuto-check: notes
  • SEO Performance

    AgriciDaniel/codex-seo

    Performance specialist for full audits. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub stars~733 tokensUpdated 28 days ago
    Frontend & DesignAuto-check passed
  • SEO Fundamentals

    xenitV1/Antigravity-Workflows

    SEO fundamentals, E-E-A-T, Core Web Vitals, and Google algorithm principles.

    130 GitHub starsUsed in 2 repos~696 tokens
    Frontend & DesignAuto-check passed
  • Roier SEO

    davila7/claude-code-templates

    Technical SEO auditor and fixer. An agent skill from davila7/claude-code-templates.

    33k GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed

More from AgriciDaniel/claude-seo

All 33 skills in this repo
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Auto-check passed
  • 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
    Auto-check passed
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Auto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    19k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed

Questions about SEO Unlighthouse

What does SEO Unlighthouse do?

Multi-page Lighthouse audit via the MIT-licensed Unlighthouse CLI. SEO Unlighthouse is an agent skill from AgriciDaniel/claude-seo. Multi-page Lighthouse audit via the MIT-licensed Unlighthouse CLI.

When should I use SEO Unlighthouse?

SEO Unlighthouse fits situations like: tasks that involve Web performance.

How do I install SEO Unlighthouse in Claude Code?

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

How do I install SEO Unlighthouse in Codex?

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

Can I use SEO Unlighthouse 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 AgriciDaniel/claude-seo --skill seo-unlighthouse -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-unlighthouse, .gemini/skills/seo-unlighthouse, .github/skills/seo-unlighthouse and .opencode/skills/seo-unlighthouse in your project.

What does SEO Unlighthouse need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Unlighthouse is instructions for the agent only. Compatibility (from SKILL.md): Requires Node 18+ and the unlighthouse npm package. Run extensions/unlighthouse/install.sh to pre-warm..

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

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

About 617 tokens (SKILL.md is roughly 2.5k 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 Unlighthouse?

Skills that share tags, products or a category with SEO Unlighthouse: SEO Google (AgriciDaniel/codex-seo, 799 stars), Landing Craft (EliasOulkadi/shokunin, 114 stars), Ship Check (textura-agency/next16-claude-starter, 133 stars) and SEO Performance (AgriciDaniel/codex-seo, 799 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Unlighthouse?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,627 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 4, 2026.

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