← All skills Β· Web

🩺 Website Health Check

Audits a URL for speed, SEO, schema and broken links and returns a fix list ranked by impact.

v0.1.0In testing⏱ setup ~10 min
Free

Everything on Skillaisle is free during early access. This skill is still in testing, so the download goes live once it passes.

Tell me when it's ready

Who it's for

Site owners, agencies, freelancers handing work to developers.

You give it

A URL (optionally PageSpeed / Lighthouse results).

You get back

Prioritized fix list, developer-ready tickets, before/after report template.

Output preview

Task given to the agent: β€œRun a health check on the site in the site/ folder and give me a fix list.”

BEFORE Β· same task, no skill
The site has several issues to fix before launch. No files were changed.

| Priority | Finding | Fix |
|---|---|---|
| High | Hero image cannot be decoded by Pillow. | Replace `site/img/hero.jpg` with a valid image. Used at [index.html:13](site/index.html:13). |
| High | Contact links on all three pages point to missing `contact.html`; the shop product link also targets a missing page. | Add the destination pages or update the links. See [shop.html:10](site/shop.html:10). |
| High | Home and shop canonical URLs point to `example.com`. | Replace them with the real public URLs. See [index.html:8](site/index.html:8) and [shop.html:7](site/shop.html:7). |
| Medium | About page explicitly blocks search indexing. | Remove `noindex` if this should be a public, searchable page. [about.html:7](site/about.html:7). |
| Medium | Shop lacks a viewport tag; the home hero has a fixed 1600px width without responsive styling. | Add the viewport tag and responsive image CSS such as `max-width:100%; height:auto`. |
| Medium | Hero image has no `alt` attribute. | Add descriptive alternative text, or `alt=""` if decorative. [index.html:13](site/index.html:13). |
| Medium | Product image is a 10Γ—10 SVG containing a black circle. | Replace it with an actual product image. [mug.svg](site/img/mug.svg). |
| Low | About has two top-level headings and no meta description; shop’s title is only β€œShop.” | Use a clear heading hierarchy, add an About description, and give Shop a descriptive branded title. |

Checked all three HTML pages, local link targets, and image assets. Browser rendering and HTTP
…
Show full output
The site has several issues to fix before launch. No files were changed.

| Priority | Finding | Fix |
|---|---|---|
| High | Hero image cannot be decoded by Pillow. | Replace `site/img/hero.jpg` with a valid image. Used at [index.html:13](site/index.html:13). |
| High | Contact links on all three pages point to missing `contact.html`; the shop product link also targets a missing page. | Add the destination pages or update the links. See [shop.html:10](site/shop.html:10). |
| High | Home and shop canonical URLs point to `example.com`. | Replace them with the real public URLs. See [index.html:8](site/index.html:8) and [shop.html:7](site/shop.html:7). |
| Medium | About page explicitly blocks search indexing. | Remove `noindex` if this should be a public, searchable page. [about.html:7](site/about.html:7). |
| Medium | Shop lacks a viewport tag; the home hero has a fixed 1600px width without responsive styling. | Add the viewport tag and responsive image CSS such as `max-width:100%; height:auto`. |
| Medium | Hero image has no `alt` attribute. | Add descriptive alternative text, or `alt=""` if decorative. [index.html:13](site/index.html:13). |
| Medium | Product image is a 10Γ—10 SVG containing a black circle. | Replace it with an actual product image. [mug.svg](site/img/mug.svg). |
| Low | About has two top-level headings and no meta description; shop’s title is only β€œShop.” | Use a clear heading hierarchy, add an About description, and give Shop a descriptive branded title. |

Checked all three HTML pages, local link targets, and image assets. Browser rendering and HTTP checks were blocked by environment restrictions, so visual behavior and deployment settings remain unverified.
AFTER Β· with the skill
# Site health report: site/
Scanned: 3 pages Β· 2026-10-18

## Summary
The Contact navigation link is broken on all three pages, and the shop's product link also points to a missing file. The shop lacks a mobile viewport, About explicitly blocks indexing, and the homepage image lacks alt text and exceeds 300 KB. Canonical tags need deployment-domain verification, while About needs a description and heading cleanup and Shop needs a descriptive title.

This is a read-only audit of all three local HTML pages and their referenced local files; the site files were not changed. No live deployment, rendering, network timings, or Lighthouse scores were measured. Ranking uses `impact Γ— 2 βˆ’ effort`, descending; ties prioritize severity, then user impact. Impact and effort use 1–5 scales.

## Top fixes (ranked)
| # | Issue | Pages | Severity | Impact | Effort | Owner |
|---|---|---|---|---|---|---|
| 1 | T1: Repair missing navigation and product destinations | All 3 | High | 5 | 2 | Developer |
| 2 | T2: Add homepage image alt text | index.html | Medium | 5 | 2 | Content |
| 3 | T3: Verify canonical domain and add About canonical | All 3 | Medium | 5 | 2 | Developer |
| 4 | T4: Reduce homepage image weight | index.html | Medium | 5 | 2 | Developer |
| 5 | T5: Add shop mobile viewport | shop.html | High | 4 | 1 | Developer |
| 6 | T6: Review About indexing restriction | about.html | High | 3 | 1 | Developer |
| 7 | T7: Make the shop title descriptive | shop.html | Low | 3 | 1 | Content |
| 8 | T8: Add About meta description | about.html | Medium | 2 | 1 | Content |
| 9 | T9: Use one
…
Show full output
# Site health report: site/
Scanned: 3 pages Β· 2026-10-18

## Summary
The Contact navigation link is broken on all three pages, and the shop's product link also points to a missing file. The shop lacks a mobile viewport, About explicitly blocks indexing, and the homepage image lacks alt text and exceeds 300 KB. Canonical tags need deployment-domain verification, while About needs a description and heading cleanup and Shop needs a descriptive title.

This is a read-only audit of all three local HTML pages and their referenced local files; the site files were not changed. No live deployment, rendering, network timings, or Lighthouse scores were measured. Ranking uses `impact Γ— 2 βˆ’ effort`, descending; ties prioritize severity, then user impact. Impact and effort use 1–5 scales.

## Top fixes (ranked)
| # | Issue | Pages | Severity | Impact | Effort | Owner |
|---|---|---|---|---|---|---|
| 1 | T1: Repair missing navigation and product destinations | All 3 | High | 5 | 2 | Developer |
| 2 | T2: Add homepage image alt text | index.html | Medium | 5 | 2 | Content |
| 3 | T3: Verify canonical domain and add About canonical | All 3 | Medium | 5 | 2 | Developer |
| 4 | T4: Reduce homepage image weight | index.html | Medium | 5 | 2 | Developer |
| 5 | T5: Add shop mobile viewport | shop.html | High | 4 | 1 | Developer |
| 6 | T6: Review About indexing restriction | about.html | High | 3 | 1 | Developer |
| 7 | T7: Make the shop title descriptive | shop.html | Low | 3 | 1 | Content |
| 8 | T8: Add About meta description | about.html | Medium | 2 | 1 | Content |
| 9 | T9: Use one primary heading on About | about.html | Medium | 2 | 1 | Content |

## Broken links
| Broken link | Found on page |
|---|---|
| contact.html | site/index.html |
| contact.html | site/about.html |
| contact.html | site/shop.html |
| products/speckled-mug.html | site/shop.html |

These are four broken link occurrences targeting two missing files. All other internal `href` destinations resolve locally; both image source files exist.

## Tickets
### T1: Repair missing navigation and product destinations
- Where: Navigation in site/index.html, site/about.html, and site/shop.html; product link in site/shop.html.
- Problem: Every navigation includes `href="contact.html"`, but site/contact.html does not exist. Shop links to `products/speckled-mug.html`, but site/products/speckled-mug.html does not exist.
- Fix: Point each link to the intended existing destination or create the missing contact and product pages. Remove a link if its destination is intentionally unavailable.
- Done when: Every internal href resolves to an existing file or a verified deployed route, and Contact and Speckled mug reach their intended pages.

### T2: Add homepage image alt text
- Where: site/index.html, image `img/hero.jpg`.
- Problem: `<img src="img/hero.jpg" width="1600" height="900">` has no `alt` attribute.
- Fix: Review the actual visual and provide concise alt text describing its useful content; use `alt=""` if it is purely decorative.
- Done when: Every image has an alt attribute appropriate to its purpose, verified against the image content.

### T3: Verify canonical domain and add About canonical
- Where: site/index.html, site/shop.html, site/about.html.
- Problem: Homepage canonical is `https://example.com/`; Shop canonical is `https://example.com/shop.html`; About has none. The intended production domain is not supplied, so the existing domain cannot be confirmed as correct.
- Fix: Confirm the production origin and preferred URL format, replace example.com if it is a placeholder, and add an About canonical using its preferred production URL. Keep About's canonical and indexing intent consistent with T6.
- Done when: Each page declares one canonical pointing to its intended preferred production URL, and those URLs resolve on deployment.

### T4: Reduce homepage image weight
- Where: site/img/hero.jpg, referenced by site/index.html.
- Problem: The file is 430,086 bytes (430.1 KB decimal; 420.0 KiB), above the 300 KB audit threshold. This is file weight, not a measured loading-time result.
- Fix: Optimize compression and dimensions for actual display sizes; consider WebP/AVIF and responsive sources while preserving acceptable visual quality.
- Done when: The image delivered at each intended viewport is at most 300,000 bytes, looks acceptable, and has no broken references.

### T5: Add shop mobile viewport
- Where: site/shop.html, head.
- Problem: No `<meta name="viewport">` is present.
- Fix: Add `<meta name="viewport" content="width=device-width, initial-scale=1">` to match the other two pages.
- Done when: Shop contains one correct viewport declaration and displays legibly at mobile widths without unintended horizontal scrolling.

### T6: Review About indexing restriction
- Where: site/about.html, head.
- Problem: `<meta name="robots" content="noindex">` explicitly asks search engines not to index About. This may be intentional; deployment intent is unknown.
- Fix: Confirm whether About should appear in search. Remove the noindex directive if public indexing is intended; otherwise document the reason to retain it.
- Done when: The deployed robots directive matches the confirmed indexing policy, including any HTTP-level robots directives.

### T7: Make the shop title descriptive
- Where: site/shop.html, title.
- Problem: `<title>Shop</title>` has 4 characters, below this audit's 30–60 character guideline.
- Fix: Use a specific title such as `Shop Handmade Stoneware | Clay & Kiln Studio` (43 characters). The guideline is an editorial check, not an indexing requirement.
- Done when: The title clearly identifies the shop and brand, is unique, and meets the chosen length guideline.

### T8: Add About meta description
- Where: site/about.html, head.
- Problem: No meta description exists.
- Fix: Add an accurate, unique description of the studio and its potters, using the audit guideline of 70–160 characters.
- Done when: Exactly one nonempty description exists and its text accurately summarizes About within that range.

### T9: Use one primary heading on About
- Where: site/about.html, body.
- Problem: Two h1 elements contain `About us` and `Our studio`.
- Fix: Keep `About us` as the primary h1 and make `Our studio` an h2 under it.
- Done when: About has one h1 and the section headings follow a meaningful hierarchy.

## Other checks
- All three pages declare `lang="en"`.
- Homepage and About have viewport declarations; homepage and Shop each have one h1.
- Homepage title: 39 characters; About title: 49 characters. Both meet the 30–60 character guideline.
- Homepage description: 101 characters; Shop description: 94 characters. Both meet the 70–160 character guideline.
- Shop's mug image has alt text (`Speckled stoneware mug`) and its SVG file is 99 bytes.
- No JSON-LD blocks are present on any page, so there is no JSON-LD syntax to validate. Adding relevant structured data is an optional enhancement, not a detected parsing defect.

Real, unedited output from recorded runs on Oct 18, 2026 Β· Codex (codex-cli 0.163.0) Β· model gpt-6.1-sol. Test inputs are fixtures (fictional brand, example.com links). AI output can be wrong: check facts before you publish anything like it.

What's in the pack

  • website-health-check/references/scoring.md
  • website-health-check/SKILL.md

Install

Unzip first. You get a folder named website-health-check containing SKILL.md. Put it in your tool's skills folder:

  • Claude Code~/.claude/skills/website-health-check/
  • Codex~/.agents/skills/website-health-check/
  • Cursor~/.cursor/skills/website-health-check/
  • Claude.ai Customize β†’ Skills β†’ + β†’ Create skill β†’ Upload a skill, then pick the ZIP (code execution must be on).

Step-by-step install guide. Only the tools listed under β€œWorks with β†’ tested” have passed a recorded run.

Trigger test pack

Should trigger
  • "Run a health check on example.com"
  • "Audit this site for SEO and broken links"
  • "Why is my homepage slow? Give me a fix list"
Should NOT trigger
  • "Write a blog post about patio heaters"
  • "Translate this page"

Acceptance checks

  • Every issue has a severity and an owner
  • Top 10 fixes ranked by impact
  • Each broken link listed with source page

Each acceptance check is run automatically on every recorded test. See the test log below.

Security label

ScriptsNone
Network callsOnly the site URL you give it (none for a local folder)
CredentialsNone
Writes filesWrites the report file
Remote instructionsNever β€” everything is in the pack
Pack contentsText files only, no executable code (checked at build)

Works with

Claude Codenot tested yetClaude.ainot tested yetCodexnot tested yetCursornot tested yet

Dependencies & cost: Your AI agent subscription only. No extra API keys.

Known limitations

  • Samples pages; not a full crawler for very large sites
  • Does not change your site

Pairs with an n8n flow

⚑ Weekly site health check β†’ alertSchedule Β· HTTP Β· AI agent Β· Email / Slack Β· setup ~20 min

Version log

v0.1.0Pre-release. In testing; not yet published.

Test log

Date (UTC)ToolModelRunResultChecksTokens in / out
Oct 18, 2026Codexgpt-5.4-miniTestFailed
3/13
  • βœ“ codex exited cleanly
  • βœ— skill was loaded (SKILL.md read)
  • βœ— report file written
  • βœ“ site files not modified (unchanged)
  • βœ— broken contact.html link listed
  • βœ— broken products/speckled-mug.html listed with source page shop.html
  • βœ— missing alt on hero image found
  • βœ— oversized hero.jpg flagged with size
  • βœ— missing viewport on shop.html found
  • βœ— noindex on about.html flagged
  • βœ— ranked table with severity and owner, ≀10 rows (0 rows)
  • βœ— developer tickets with "Done when"
  • βœ“ no invented speed scores
45,368 / 671
Oct 18, 2026Codexgpt-6.1-solTestPassed
13/13
  • βœ“ codex exited cleanly
  • βœ“ skill was loaded (SKILL.md read)
  • βœ“ report file written
  • βœ“ site files not modified (unchanged)
  • βœ“ broken contact.html link listed
  • βœ“ broken products/speckled-mug.html listed with source page shop.html
  • βœ“ missing alt on hero image found
  • βœ“ oversized hero.jpg flagged with size
  • βœ“ missing viewport on shop.html found
  • βœ“ noindex on about.html flagged
  • βœ“ ranked table with severity and owner, ≀10 rows (9 rows)
  • βœ“ developer tickets with "Done when"
  • βœ“ no invented speed scores
96,134 / 3,391
Oct 18, 2026Codexgpt-6.1-solBaseline (no skill)Comparison only
3/12
  • βœ“ codex exited cleanly
  • βœ— report file written
  • βœ“ site files not modified (unchanged)
  • βœ— broken contact.html link listed
  • βœ— broken products/speckled-mug.html listed with source page shop.html
  • βœ— missing alt on hero image found
  • βœ— oversized hero.jpg flagged with size
  • βœ— missing viewport on shop.html found
  • βœ— noindex on about.html flagged
  • βœ— ranked table with severity and owner, ≀10 rows (0 rows)
  • βœ— developer tickets with "Done when"
  • βœ“ no invented speed scores
121,273 / 1,825
Oct 18, 2026Codexgpt-6.1-solTestFailed
12/13
  • βœ“ codex exited cleanly
  • βœ“ skill was loaded (SKILL.md read)
  • βœ“ report file written
  • βœ“ site files not modified (unchanged)
  • βœ“ broken contact.html link listed
  • βœ“ broken products/speckled-mug.html listed with source page shop.html
  • βœ“ missing alt on hero image found
  • βœ— oversized hero.jpg flagged with size
  • βœ“ missing viewport on shop.html found
  • βœ“ noindex on about.html flagged
  • βœ“ ranked table with severity and owner, ≀10 rows (9 rows)
  • βœ“ developer tickets with "Done when"
  • βœ“ no invented speed scores
95,330 / 3,270

Each row is a real run recorded by our test runner. For each tool, the latest test run decides whether it appears under β€œTested on”. Baseline runs do the same task with no skill installed and never count.