/suede-visibility-grader · Website visibility and CTA grading

Would an answer engine even mention you?

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

"grade this page before I promote it" /suede-visibility-grader Ask in plain words. The router reads the request and loads this lane; MCP agents find it with list_suede_skills.

$ /suede-visibility-grader yourpage.com first screen · CTA pull · proof · AI readability cited by answer engines: not yet VISIBILITY: C+ · FIX LIST RANKED

Public install command

Claude Code — project-level copy:

git clone https://github.com/JasonColapietro/suede-creator-skills.git /tmp/suede-creator-skills
mkdir -p .claude/skills
cp -R /tmp/suede-creator-skills/skills/suede-visibility-grader .claude/skills/

Or install the full pack: /plugin marketplace add JasonColapietro/suede-creator-skills then /plugin install suede-skills@suede.

Codex — 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 evidence 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 publicly, 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 evidence 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.