Kill AI Slop Documentation

Pages

1. OverviewWhat Kill AI Slop exposes: the agent skill, scanner entry points, shared catalogue, and field-guide site, plus who should use which surface first.
2. InstallationInstall the kill-ai-slop skill via npx or manual copy, and set up the Astro website dependencies for local development.
3. QuickstartShortest path to a first scanner report and a local field-guide run, with expected success signals and one recovery note each.
4. Slop taxonomyRepo-specific model of AI-slop tells: categories, named signals, and how the field guide and skill share the same taxonomy language.
5. Catalogue modelHow catalogue.ts is the single source of truth for tells, how demos and i18n attach, and boundaries between site data and skill references.
6. Skill workflowAgent skill lifecycle: scan, triage, report, then propose or apply fixes without silent file edits from the standalone scanner.
7. Use the agent skillInvoke kill-ai-slop inside a coding agent after install: prompts, expected host behavior, and how the skill uses references and the scanner.
8. Scan a web projectPoint the dependency-free scanner at a project path, interpret grouped vs JSON reports, and verify findings against detection rules.
9. Apply clean fixesMap scanner hits to remediation steps from the fixes playbook, choose propose vs apply in an agent host, and confirm the clean alternative.
10. Run the field guide siteDevelop and preview the multilingual Astro field guide: install, dev server, static build output, and how entries and demos render on the index.
11. Extend the catalogueAdd or update a tell: catalogue entry, i18n strings, plain-HTML demo, and alignment with skill taxonomy, detection, and fix references.
12. Scanner CLI referenceInvocation, path argument, --json mode, walk/scan behavior, console formatting helpers, and hard constraint that the scanner never edits files.
13. Detection patternsCode-level signals the skill and scanner look for per tell: patterns, match targets, and how findings map back to taxonomy ids.
14. Remediation playbookPer-tell clean fixes, what to remove or replace, and how before or after demos illustrate the preferred outcome.
15. Catalogue and demos dataFields and shapes in catalogue.ts, catalogue.i18n.ts, and demos.ts: tell ids, copy locales, and demo HTML payloads used by site components.
16. Design tokensSite self-constraints in tokens and global styles: paper and ink palette, single editorial red, hierarchy rules, and banned slop defaults.
17. Build and deployStatic site build to dist, deploy-anywhere assumptions, and operational notes for the zero-JS-by-default Astro field guide.
18. ContributingWhere to change skill references, scanner logic, catalogue data, or site components while keeping skill and website taxonomy aligned.