JasonColapietro/suede-creator-skills / skills/suede-visibility-grader
suede-visibility-grader
VerifiedGrade one public page A-F across findability, first-screen clarity, CTA pull, proof and trust, AI citation readiness, and design signal, with up to five ranked fixes. Use when asked to "grade this page before promotion" or give a quick readiness check of a landing page, README, docs, or campaign. NOT FOR: deep SEO and schema audits (use suede-seo-audit), AI crawler/citation measurement (use suede-ai-seo), or implementing conversion changes (use suede-site-alchemy).
| File | Kind | Size |
|---|---|---|
| CARD.md | markdown | 4.5 KB |
| SKILL.md | skill md | 11.0 KB |
| agents/openai.yaml | config | 468 B |
| references/sample-report.md | markdown | 1.8 KB |
| references/surface-type-standards.md | markdown | 1.9 KB |
| references/worked-handoff.md | markdown | 1.5 KB |
references/sample-report.md
View on GitHub# Sample Report
A completed grade in the required output shape. Illustration only: the contract is the Output Format section in SKILL.md.
## Sample Report
```text
Simple explanation:
The page is findable, but the first screen does not make the action obvious.
Fix the hero CTA and mobile proof block before promotion.
Usual breakdown:
URL or source: https://example.com
Surface type: landing page
Primary reader: creator preparing a release package
Primary action: start the release-readiness audit
Live/source status: live page inspected, source not available
Screenshot evidence: screenshots/home-desktop.png, screenshots/home-mobile.png
Viewport sizes: 1440x900, 390x844
Visual states checked: default desktop, default mobile, primary CTA hover
Visual states not checked: dark mode, logged-in state
Grades:
Findability: B
First-screen clarity: C
CTA pull: D
Proof and trust: B
AI readability: B
Design signal: C
Overall: C
Top fixes (max 5, ranked by impact on ship gate):
1. [P1] CTA pull | Hero | Primary button reads "Learn more": visitors do not know what starts the audit | Change to "Run the release audit" and route to the verified audit path | Hero CTA click-through rate (GA4 event)
2. [P2] First-screen clarity | First mobile viewport | Proof links start below the fold: trust arrives too late | Move one source link and one screenshot into the first mobile section | Mobile CTA click-through rate
3. [P3] Design signal | Hero media | Artwork does not show a release artifact, weak product signal | Replace with a rights/provenance preview or an approved product screenshot | Scroll depth past hero; CTA click-through rate
Verification:
What was checked: live URL, desktop viewport, mobile viewport, primary CTA hover state, Open Graph tags
What was not checked: dark mode, logged-in state, source files
Ship gate: ship-with-caveats
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |