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/lib/offline-reports.mjs
View on GitHubimport { lstat, mkdir, mkdtemp, realpath, rename, rm, writeFile } from "node:fs/promises";
import path from "node:path";
export function markdownText(value) {
return String(value ?? "").replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">")
.replace(/[\\`*_\[\]()!|]/g, (char) => `&#${char.charCodeAt(0)};`).replace(/[\r\n]+/g, " ");
}
function within(candidate, root) {
const rel = path.relative(root, candidate);
return rel === "" || (!rel.startsWith(`..${path.sep}`) && rel !== ".." && !path.isAbsolute(rel));
}
async function physicalPath(target) {
const tail = [];
let current = path.resolve(target);
while (true) {
try { return path.join(await realpath(current), ...tail.reverse()); }
catch (error) {
if (error.code !== "ENOENT") throw error;
tail.push(path.basename(current));
const parent = path.dirname(current);
if (parent === current) throw error;
current = parent;
}
}
}
// New directories only. Report output may live in ignored reports/ or outside
// the repository; resolve existing ancestors before mkdir to protect source.
export async function writeOfflineReports(output, files, repoRoot) {
const destination = path.resolve(output);
const root = path.resolve(repoRoot);
const allowed = path.join(root, "reports");
const safe = (target, protectedRoot, reportRoot) => {
if (within(target, protectedRoot) && (!within(target, reportRoot) || target === reportRoot)) {
throw new Error("Offline reports cannot overwrite source; choose a new reports/ subdirectory or an external directory");
}
};
safe(destination, root, allowed);
safe(await physicalPath(destination), await realpath(root), path.join(await realpath(root), "reports"));
try { await lstat(destination); throw new Error(`Output already exists: ${destination}`); }
catch (error) { if (error.code !== "ENOENT") throw error; }
const entries = Object.entries(files);
if (!entries.length || entries.some(([name, contents]) => !/^[a-z0-9][a-z0-9_.-]*$/i.test(name) || typeof contents !== "string")) {
throw new Error("Offline reports require plain filenames and text contents");
}
const parent = path.dirname(destination);
await mkdir(parent, { recursive: true });
const scratch = await mkdtemp(path.join(parent, ".seo-review-"));
try {
for (const [name, contents] of entries) await writeFile(path.join(scratch, name), contents, { flag: "wx" });
await rename(scratch, destination);
} catch (error) { await rm(scratch, { recursive: true, force: true }); throw error; }
return destination;
}
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 |