Kartik-Doye/Ravengard-AI-Recruiter / .agents/skills/findable
findable
VerifiedAudits and improves web discoverability across crawlability, HTTP status, rendering, indexability, canonical metadata, titles, descriptions, internal links, sitemaps, robots rules, social previews, and eligible structured data. Use for technical SEO without ranking promises.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.5 KB |
| references/research.md | markdown | 922 B |
| references/seo-checklist.md | markdown | 3.0 KB |
references/seo-checklist.md
View on GitHub# SEO checklist: verify on rendered HTML, per page type
Commands assume `curl -s <url>`; the rendered/deferred HTML matters more
than the template.
## Per-page metadata
| Check | Good | Broken tell |
| --- | --- | --- |
| Title | unique, descriptive, and checked in target result surfaces | every page: "Home: MyApp" |
| Meta description | unique and useful to searchers | missing, or one description site-wide |
| Canonical | absolute, self-referencing, protocol+host exact | missing; canonical to homepage everywhere |
| Open Graph | og:title, og:description, og:image (1200×630), og:url | absent; image 404s; relative URL |
| Twitter card | summary_large_image + matching tags | absent |
| Robots meta | index,follow on public pages | noindex left from staging (the classic) |
## Structure
- Exactly one `h1` per page stating the topic; `h2`/`h3` form a real
outline, not a styling ladder.
- Semantic landmarks: `header/nav/main/article/footer`; lists are
`<ul>`, not div stacks.
- Links: descriptive anchors ("read the migration guide", never
"click here"); no orphan pages (every public page reachable from
internal links); no broken internal links.
- Images: descriptive alt; width/height set (CLS); modern formats where
cheap.
## Crawlability
- `robots.txt`: exists, doesn't block public paths, sitemap referenced.
- `sitemap.xml`: only canonical 200s, lastmod honest, size limits
respected.
- Duplicate content: parameter URLs (utm, sort, page) canonicalized;
trailing-slash/case variants resolve to one canonical.
- Avoid unnecessary redirect chains; no soft-404s (successful status with
not-found content).
- Staging environments: noindex + auth: they must never be crawlable.
## Structured data (schema.org)
- Types that match reality: Organization, WebSite (+ SearchAction if a
search exists), Article/BlogPosting for posts, Product with offers for
products, BreadcrumbList for deep sites, FAQPage for actual FAQs.
- Validates (Rich Results Test / validator.schema.org); required
properties present; **describes only content actually on the page**.
- **Anti-Hallucination Check:** Verify the JSON-LD does not contain fake 5-star `AggregateRating` reviews, hallucinated authors, or URLs that 404. Fabricating schema data is an anti-pattern.
- JSON-LD in the served HTML (not injected client-side only).
## Performance & accessibility overlap (flag, don't deep-dive)
- LCP image not lazy-loaded; hero under 2.5s budget → `hotpath`.
- Render-blocking chains and uncompressed assets → `hotpath`.
- Alt text, heading order, link purpose → `friction`; dual-value work
gets done once, credited twice.
## GEO/AEO (answer engines): evidence-based only
What's defensible: stable URLs, semantic HTML, structured data, factual
self-contained content, clear headings that answer questions. What
isn't: "llms.txt will boost your rank", keyword-stuffed "AI summaries",
any claim of guaranteed AI citations. Present the defensible part as
standard good practice; decline the rest as unproven.
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: 196k | Updated | Claude CodeCodex | Verified | Install |