JasonColapietro/suede-creator-skills / skills/suede-seo-audit
suede-seo-audit
VerifiedAudit technical access, intent, metadata, links, schema, generative search, copy, E-E-A-T, and topic architecture with A-F lanes and exact fixes. Use when asked to "audit this site for SEO", investigate traffic or indexation problems, or produce a scored report. Includes offline source-review tools. NOT FOR: a quick promotion grade (use suede-visibility-grader), AI crawler and citation measurement (use suede-ai-seo), or conversion-path changes (use suede-site-alchemy).
| File | Kind | Size |
|---|---|---|
| CARD.md | markdown | 4.4 KB |
| SKILL.md | skill md | 17.6 KB |
| agents/openai.yaml | config | 723 B |
| references/google-search-guidance.md | markdown | 6.4 KB |
| references/keyword-research.md | markdown | 4.7 KB |
| references/lane-checklists.md | markdown | 24.0 KB |
| references/offline-tools.md | markdown | 4.6 KB |
| references/schema-templates.md | markdown | 10.5 KB |
| references/worked-handoff.md | markdown | 1.7 KB |
| scripts/fixtures/pages.json | config | 1003 B |
| scripts/fixtures/serp.json | config | 828 B |
| scripts/lib/audit.mjs | script | 963 B |
| scripts/lib/merchant-schema.mjs | script | 15.1 KB |
| scripts/lib/metadata-drift.mjs | script | 9.8 KB |
| scripts/lib/offline-reports.mjs | script | 2.5 KB |
| scripts/lib/page-technical.mjs | script | 16.1 KB |
| scripts/lib/serp-overlap.mjs | script | 6.9 KB |
| scripts/seo-review.mjs | script | 4.5 KB |
| scripts/tests/cli.test.mjs | script | 3.4 KB |
| scripts/tests/merchant-schema.test.mjs | script | 12.5 KB |
| scripts/tests/metadata-drift.test.mjs | script | 7.9 KB |
| scripts/tests/offline-reports.test.mjs | script | 2.6 KB |
| scripts/tests/page-technical.test.mjs | script | 9.0 KB |
| scripts/tests/serp-overlap.test.mjs | script | 5.4 KB |
scripts/tests/serp-overlap.test.mjs
View on GitHubimport test from "node:test";
import assert from "node:assert/strict";
import { mkdtempSync, readFileSync, rmSync } from "node:fs";
import path from "node:path";
import { tmpdir } from "node:os";
const api = await import("../lib/serp-overlap.mjs").catch(() => ({}));
const row = (keyword, urls) => ({ keyword, organic: urls.map((url, i) => ({ rank: i + 1, url })) });
const u = (name) => `https://results.test/${name}`;
function clusters(rows, options = {}) {
assert.equal(typeof api.clusterSerpOverlap, "function", "offline SERP-overlap clustering is absent");
return api.clusterSerpOverlap(rows, { depth: 2, threshold: 0.5, context: "Synthetic fixture, same engine/locale/device/time", ...options });
}
test("SERP overlap joins matching result URLs across seeds and preserves pair evidence", () => {
const result = clusters([row("query alpha", [u("a"), u("b")]), row("query beta", [u("a"), u("c")]), row("query gamma", [u("x"), u("y")])]);
assert.deepEqual(result.clusters.map((c) => c.keywords), [["query alpha", "query beta"], ["query gamma"]]);
assert.equal(result.pairs[0].overlap, 0.5);
assert.deepEqual(result.pairs[0].sharedUrls, [u("a")]);
assert.equal(result.clusters[0].minimumPairOverlap, 0.5);
assert.equal(result.clusters[1].minimumPairOverlap, null);
});
test("complete-link grouping avoids transitive chains and is stable under input reordering", () => {
const rows = [row("a", [u("x"), u("y")]), row("b", [u("x"), u("z")]), row("c", [u("z"), u("w")])];
const report = clusters(rows);
assert.deepEqual(report.clusters.map((c) => c.keywords), [["a", "b"], ["c"]]);
assert.deepEqual(clusters([...rows].reverse()), report);
});
test("short, duplicate-URL and gapped-rank samples are explicitly excluded", () => {
const gap = row("gap", [u("a"), u("b")]); gap.organic[1].rank = 3;
const result = clusters([row("short", [u("a")]), row("duplicate", [u("a"), `${u("a")}#section`]), gap]);
assert.equal(result.samples.length, 0);
assert.equal(result.excluded.length, 3);
assert.deepEqual(result.clusters, []);
assert.ok(result.excluded.every((r) => r.reason));
});
test("URL identity retains host, query, slash and protocol while stripping document fragments", () => {
const result = clusters([row("a", [u("x"), u("y")]), row("b", [`${u("x")}#part`, "https://other.test/y"]), row("c", [`${u("x")}/`, `${u("y")}?v=2`]), row("d", ["http://results.test/x", "http://results.test/y"])]);
assert.deepEqual(result.pairs.map((p) => [p.left, p.right]), [["a", "b"]]);
});
test("bad boundaries, duplicate keywords, mixed context and malformed rankings fail closed", () => {
for (const options of [{ depth: 0 }, { depth: 101 }, { threshold: 0 }, { threshold: 1.1 }, { context: "" }]) assert.throws(() => clusters([], options));
assert.throws(() => clusters([row("same", [u("a"), u("b")]), row(" SAME ", [u("a"), u("b")])]), /duplicate/i);
const bad = row("bad", ["javascript:alert(1)", u("b")]);
assert.throws(() => clusters([bad]), /URL|organic/i);
const mixed = { ...row("mixed", [u("a"), u("b")]), collectionContext: "Another locale" };
assert.throws(() => clusters([mixed]), /context/i);
});
test("a deeper incomplete export can still prove a fully observed top-K sample", () => {
const input = { ...row("a", [u("a"), u("b")]), serpDepthComplete: false };
const report = clusters([input]);
assert.equal(report.samples.length, 1);
assert.equal(report.samples[0].exportDepthComplete, false);
assert.equal(report.depth, 2);
});
test("dense allowed-size inputs stop at an explicit evidence budget rather than crashing or silently sampling", () => {
const one = Array.from({ length: 500 }, (_, i) => row(`query ${String(i).padStart(3, "0")}`, [u("shared")]));
assert.throws(() => clusters(one, { depth: 1, threshold: 1 }), /evidence budget.*reduce|reduce.*evidence budget/i);
const urls = Array.from({ length: 100 }, (_, i) => u(`result-${i}-${"x".repeat(60)}`));
const dense = Array.from({ length: 100 }, (_, i) => row(`query ${i}`, urls));
assert.throws(() => clusters(dense, { depth: 100, threshold: 1 }), /evidence budget.*reduce|reduce.*evidence budget/i);
});
test("overlap reports escape malicious keywords and describe review-only source scope", () => {
const result = clusters([row("", [u("a"), u("b")])]);
const md = api.renderSerpOverlap(result);
assert.ok(!md.includes(");
assert.match(md, /user-supplied|User-supplied/);
assert.match(md, /No requests/);
});
test("group ordering is identical across collection-machine locales", async () => {
const { spawnSync } = await import("node:child_process");
const moduleUrl = new URL("../lib/serp-overlap.mjs", import.meta.url).href;
const input = ["zebra", "äpple", "apple"].map(keyword => ({ keyword, organic: [{ rank: 1, url: "https://example.test/shared" }] }));
const script = `import { clusterSerpOverlap } from ${JSON.stringify(moduleUrl)}; console.log(JSON.stringify(clusterSerpOverlap(${JSON.stringify(input)}, {depth:1,threshold:1,context:"Synthetic fixture only"}).clusters));`;
const outputs = ["en_US.UTF-8", "sv_SE.UTF-8"].map(locale => {
const result = spawnSync(process.execPath, ["--input-type=module", "-e", script], { encoding: "utf8", env: { ...process.env, LANG: locale, LC_ALL: locale } });
assert.equal(result.status, 0, result.stderr);
return result.stdout;
});
assert.equal(outputs[0], outputs[1]);
assert.deepEqual(JSON.parse(outputs[0])[0].keywords, ["apple", "zebra", "äpple"]);
});
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 |