feat(skills): add SearchD AEO audit 🤖🤖🤖

[junhodo]

Summary

Adds a focused Agent Skill for measuring how often a company appears in answer-engine research, which competitors appear instead, and which public sources shape those answers.

The contribution is distinct from landing-page conversion and advertising analysis: it freezes buyer-authentic questions, isolates neutral research workers from the target brand, preserves run-level provenance, and renders an auditable English or Korean HTML report.

Changes

• Add skills/searchd-aeo-audit with deterministic Python parsing, aggregation, schema validation, and self-contained report rendering
• Preserve completed and failed research runs, source URLs, excerpts, agent/version metadata, and evidence-linked recommendations
• Reject unsafe citation protocols before rendering clickable links
• Update the generated skills catalog

Paid services policy

This catalog version contains no agency CTA, paid-service recommendation, sponsored link, credentials, or paid-service dependency. The only attribution link points to the public open-source repository containing the implementation.

Verification

• npm run skill:validate: all 419 skills valid
• npm run build: generated catalog is reproducible from a clean tree
• uv run --with pytest pytest -q tests: 10 passed
• uvx ruff check .: clean
• uvx --with pytest basedpyright: 0 errors and 0 warnings
• JSON Schema validation: passed
• Desktop 1280px and mobile 375px browser QA: no page-level overflow; commercial CTA absent

Bundled assets

Every bundled script, schema, reference, template, example, test/config, design document, README, license, and ignore file is referenced from SKILL.md. Generated catalog assets match the committed tree and contain no cache or bytecode files.

[github-actions]

🔒 PR Risk Scan Results

Scanned 22 changed file(s).

Severity	Count
🔴 High	0
🟠 Medium	10
ℹ️ Info	10

Severity	Rule	File	Line	Match
🟠	package-exec-command	skills/searchd-aeo-audit/README.md	12	npx skills add runbear-io/searchd-skills --skill searchd-aeo-audit
🟠	package-exec-command	skills/searchd-aeo-audit/README.md	19	npx skills add runbear-io/searchd-skills \\
🟠	package-exec-command	skills/searchd-aeo-audit/README.md	63	uvx ruff check .
🟠	package-exec-command	skills/searchd-aeo-audit/README.md	64	uvx --with pytest basedpyright
🟠	package-exec-command	skills/searchd-aeo-audit/README.md	65	uvx check-jsonschema \\
🟠	unpinned-version-indicator	skills/searchd-aeo-audit/schemas/audit.schema.json	43	"id": { "type": "string", "pattern": "^q[0-9]{2}$" },
🟠	unpinned-version-indicator	skills/searchd-aeo-audit/schemas/audit.schema.json	79	"id": { "type": "string", "pattern": "^r[0-9]{2,}$" },
🟠	unpinned-version-indicator	skills/searchd-aeo-audit/schemas/audit.schema.json	80	"question_id": { "type": "string", "pattern": "^q[0-9]{2}$" },
🟠	unpinned-version-indicator	skills/searchd-aeo-audit/schemas/audit.schema.json	111	"pattern": "^https?://[^\\\\s]+$"
🟠	unpinned-version-indicator	skills/searchd-aeo-audit/schemas/audit.schema.json	152	"items": { "type": "string", "pattern": "^r[0-9]{2,}$" },
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/aggregate.py	1	skills/searchd-aeo-audit/scripts/aggregate.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/audit_fields.py	1	skills/searchd-aeo-audit/scripts/audit_fields.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/audit_parse.py	1	skills/searchd-aeo-audit/scripts/audit_parse.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/audit_types.py	1	skills/searchd-aeo-audit/scripts/audit_types.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/render_report.py	1	skills/searchd-aeo-audit/scripts/render_report.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/report_common.py	1	skills/searchd-aeo-audit/scripts/report_common.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/report_evidence.py	1	skills/searchd-aeo-audit/scripts/report_evidence.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/report_locale.py	1	skills/searchd-aeo-audit/scripts/report_locale.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/scripts/report_questions.py	1	skills/searchd-aeo-audit/scripts/report_questions.py
ℹ️	skill-script-touched	skills/searchd-aeo-audit/tests/test_render_report.py	1	skills/searchd-aeo-audit/tests/test_render_report.py

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

[github-actions]

🟡 Contributor Reputation Check: MEDIUM risk

Check	Risk
Profile	MEDIUM
Credential audit	NONE

Maintainers: please review this contributor before merging.
See the workflow run for full details.
Automated check powered by AGT.

[github-actions]

🔍 Vally Lint Results

✅ All checks passed

Scope	Checked
Skills	1
Agents	0
Total	1

Severity	Count
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	✅ searchd-aeo-audit (2/2 checks passed)
ℹ️	✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️	✓ spec-compliance: All spec checks passed.
ℹ️	✓ [valid-refs] All file references across 1 skill(s) are valid.
ℹ️	✓ valid-refs: All file references resolve to existing files within the skill directory.
ℹ️	1 skill(s) linted, 1 passed

Full linter output

### Linting skills/searchd-aeo-audit
✅ searchd-aeo-audit (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

[junhodo]

Browser QA evidence

Desktop — 1280px full report

Mobile — 375px masthead and executive summary

Observed: no page-level horizontal overflow, 0% metric preserved, open-source GitHub attribution present, and no commercial CTA.

[aaronpowell]

This is not suited for the repo at this time.