Individual skill
suggest-improvements
List what is worth fixing on a site the conversion reproduced as-is — SEO, content, links, accessibility, performance, security, analytics and design — each item with its path, evidence, effort, risk and whether it can be applied mechanically, plus the agent's own design and content observations. Use after the parity gates and the visual review are green and before the pull request, or when someone asks what could be better on the converted site. It changes nothing.
skills/suggest-improvements/SKILL.md
Source commit 8beb1de5099a2be1ddb1d98ffc7b3682343bc420
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 6, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 123
- Repository last updated
- Oct 31, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent-skills Repository topic
- ai-agents Repository topic
- astro Repository topic
- claude-code Repository topic
- cloudflare-pages Repository topic
- codex Repository topic
- jamstack Repository topic
- playwright Repository topic
- seo Repository topic
- site-migration Repository topic
- design Derived category
- marketing Derived category
- writing Derived category
- data Derived category
- security Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 6,217 bytesreferences/catalogue.mddoc · 5,134 bytesscripts/checks/broken-links.mjsruns · 1,817 bytesscripts/checks/dead-analytics.mjsruns · 1,637 bytesscripts/checks/duplicate-analytics.mjsruns · 1,270 bytesscripts/checks/duplicate-titles.mjsruns · 976 bytesscripts/checks/http-links.mjsruns · 1,129 bytesscripts/checks/inconsistent-spacing.mjsruns · 1,746 bytesscripts/checks/long-titles.mjsruns · 623 bytesscripts/checks/missing-alt.mjsruns · 1,069 bytesscripts/checks/missing-descriptions.mjsruns · 613 bytesscripts/checks/missing-h1.mjsruns · 474 bytesscripts/checks/missing-security-headers.mjsruns · 2,360 bytesscripts/checks/mixed-content.mjsruns · 1,383 bytesscripts/checks/mobile-overflow.mjsruns · 1,681 bytesscripts/checks/multiple-h1.mjsruns · 527 bytesscripts/checks/no-webp.mjsruns · 840 bytesscripts/checks/noindex-in-sitemap.mjsruns · 631 bytesscripts/checks/orphan-pages.mjsruns · 1,600 bytesscripts/checks/oversized-images.mjsruns · 2,942 bytesscripts/checks/placeholder-text.mjsruns · 1,355 bytesscripts/checks/redirect-chains.mjsruns · 609 bytesscripts/checks/render-blocking-scripts.mjsruns · 2,687 bytesscripts/checks/shortcode-leftovers.mjsruns · 1,848 bytesscripts/checks/stale-dates.mjsruns · 1,175 bytesscripts/checks/thin-pages.mjsruns · 1,188 bytesscripts/lib/item.mjsruns · 2,297 bytesscripts/lib/load.mjsruns · 3,724 bytesscripts/lib/node-version.mjsruns · 1,083 bytesscripts/lib/pages.mjsruns · 3,091 bytesscripts/lib/report.mjsruns · 4,808 bytesscripts/suggest.mjsruns · 5,785 bytes
Read excerpt
# suggest-improvements
The converted site reproduces the live site on purpose, flaws included. This skill writes down
the flaws, with evidence, so the site owner can decide which to fix. It never fixes them.
## The golden rule
**Nothing from here is applied directly.** An improvement becomes a proposal: an entry in
`proposals.json` that ships only in a `PROPOSALS=on` build until a person approves it, or a later
`convert-site --apply <id>` run that does the same on its own commit. Editing the default build
because this report said so breaks parity, and the gates will say so.
## When to run
