Website visibility and CTA grading

Grade whether a page can be found, trusted, cited, and clicked.

Suede Visibility Grader gives public pages an A-F report across findability, first-screen clarity, CTA pull, proof and trust, AI readability, rendered design signal, evidence, and grade caps. Use it for websites, GitHub Pages docs, launch pages, campaign pages, creator sites, and Suedify QA.

Install the skill View skill folder

Public install command

This is the public route. It installs from GitHub as a standard Codex skill folder.

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo JasonColapietro/suede-creator-skills \
  --path skills/suede-visibility-grader

Restart Codex after installing the skill.

What it checks

  • Live URL status, redirects, canonical, robots, sitemap, title, and description.
  • First-screen clarity: who the page is for, what changes, and what action comes next.
  • CTA pull: button text, proof path, secondary action, and next-step friction.
  • Proof and trust: source files, screenshots, commands, manifests, authorship, docs, and claim boundaries.
  • AI readability: answer-ready summaries, schema fit, sourceable claims, internal links, and citation-friendly headings.
  • Design signal: hierarchy, first-viewport composition, spacing, typography, image quality, icon fidelity, responsive behavior, accessibility, AI-slop risk, and contrast.

Where it fits

Use it before a page gets promoted, shared with ambassadors, linked from a repo, added to an article, or pushed through Suedify. It pairs well with SEO/AEO/AI EO audits because it checks whether search, answer engines, Google result surfaces, Gemini result surfaces, and humans can all understand the same page.

For this repo, the grader should treat GitHub Pages as the actual public docs surface generated from the public repository, not as a separate marketing site.

Grade lanes

FindabilityStatus, canonical, robots, sitemap, title, description, durable keywords, and duplicate URL risk.
First-screen clarityWhether the first viewport names the audience, outcome, proof, and action.
CTA pullPrimary action, secondary proof action, link target, button language, and why someone should click now.
Proof and trustScreenshots, commands, docs, manifests, source files, receipts, authorship, and safe claim boundaries.
AI readabilityAnswer-ready copy, schema, sourceable claims, internal links, citation-friendly headings, and AI EO surface area.
Design signalHierarchy, spacing, type, image treatment, responsiveness, contrast, and whether the page looks intentional.

Output format

The grader starts with a simple non-coder explanation, then gives the usual breakdown, source/live status, screenshot evidence, viewport states, lane grades, grade caps, top fixes, CTA rewrites, verification notes, and a ship gate.

Grades:
Findability: A-F
First-screen clarity: A-F
CTA pull: A-F
Proof and trust: A-F
AI readability: A-F
Design signal: A-F
Overall: A-F

Agent-team fit

On major work, use the visibility grader as its own lane between builder and release verifier. Pair it with design review, A-F code grading, adversarial review, and final handoff so the page is checked from multiple angles before anyone claims it is ready.

Best prompts

Use $suede-visibility-grader to grade this page A-F for findability, first-screen clarity, CTA pull, proof, AI readability, rendered design signal, evidence, and promotion readiness.
Use $suede-visibility-grader on this GitHub Pages docs site. Treat it as the actual public repo docs surface, not a separate marketing site.
Use $suede-visibility-grader to check whether this page is ready for Google and Gemini result surfaces, then rewrite the primary and secondary CTAs.

Safety boundary

The A-F grade is a working review, not an audited business metric. The skill does not invent traffic, ranking, conversion, partner, legal, payout, or placement claims.

Keep Google and Gemini result receipts named for the surface they actually show.

Cue Suede

Feedback can happen mid-workflow or at the end. Say Cue Suede to ask for choices: change something, preserve what worked so the agent can mimic it later, or keep as-is by saying nothing.