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/cli.test.mjs
View on GitHubimport test from 'node:test';
import assert from 'node:assert/strict';
import { mkdtempSync, readFileSync, writeFileSync, existsSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { spawnSync } from 'node:child_process';
const scripts = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
const cli = path.join(scripts, 'seo-review.mjs');
const fixture = (name) => path.join(scripts, 'fixtures', name);
const run = (...args) => spawnSync(process.execPath, [cli,...args], { encoding: 'utf8', cwd: scripts });
test('installed CLI captures partial snapshots, merchant opt-in, drift and stored SERP groups', () => {
const root = mkdtempSync(path.join(tmpdir(), 'seo-cli-'));
try {
const out = path.join(root,'baseline');
let r = run('audit','--input',fixture('pages.json'),'--out',out);
assert.equal(r.status,0,r.stderr);
assert.equal(JSON.parse(readFileSync(path.join(out,'seo-audit.json'))).merchant,undefined);
const before = path.join(out,'metadata-snapshot.json');
assert.equal(JSON.parse(readFileSync(before)).coverage.complete,false);
assert.notEqual(run('audit','--input',fixture('pages.json'),'--out',out).status,0);
const merchant = path.join(root,'merchant');
r=run('audit','--input',fixture('pages.json'),'--merchant','--out',merchant);
assert.equal(r.status,0,r.stderr);
assert.equal(JSON.parse(readFileSync(path.join(merchant,'seo-audit.json'))).merchant[0].offerCount,1);
r=run('drift','--before',before,'--after',path.join(merchant,'metadata-snapshot.json'),'--out',path.join(root,'drift'));
assert.equal(r.status,0,r.stderr);
assert.deepEqual(JSON.parse(readFileSync(path.join(root,'drift','seo-drift.json'))).changes,[]);
r=run('serp-clusters','--input',fixture('serp.json'),'--context','Synthetic fixture only','--depth','2','--threshold','0.5','--out',path.join(root,'clusters'));
assert.equal(r.status,0,r.stderr);
assert.equal(JSON.parse(readFileSync(path.join(root,'clusters','serp-clusters.json'))).clusters.length,2);
} finally { rmSync(root,{recursive:true,force:true}); }
});
test('CLI rejects malformed, duplicate, foreign, over-budget inputs and unsafe source writes', () => {
const root = mkdtempSync(path.join(tmpdir(),'seo-cli-bad-'));
try {
const input = path.join(root,'bad.json');
const out=path.join(root,'output');
const good=JSON.parse(readFileSync(fixture('pages.json')));
for (const value of [{...good,pages:[]},{...good,pages:[good.pages[0],good.pages[0]]},{...good,pages:[{url:'https://foreign.test/',html:'x'}]},{...good,pages:[{...good.pages[0],html:'x'.repeat(2_000_001)}]}]) {
writeFileSync(input,JSON.stringify(value));
assert.notEqual(run('audit','--input',input,'--out',out).status,0);
assert.equal(existsSync(out),false);
}
assert.notEqual(run('audit','--input',fixture('pages.json'),'--out',path.join(scripts,'must-not-create')).status,0);
assert.equal(existsSync(path.join(scripts,'must-not-create')),false);
assert.notEqual(run('audit','--input',fixture('pages.json'),'--merchant','--merchant','--out',out).status,0);
assert.notEqual(run('serp-clusters','--input',fixture('serp.json'),'--out',out).status,0);
writeFileSync(input,'{');
assert.notEqual(run('drift','--before',input,'--after',input,'--out',out).status,0);
} finally { rmSync(root,{recursive:true,force:true}); }
});
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 |