# Kill AI Slop Documentation

> Technical docs for the kill-ai-slop agent skill, dependency-free project scanner, shared slop taxonomy, and Astro field-guide site. For engineers scanning web projects, remediating machine-default UI, or extending the catalogue and demos.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb.md)
- [Human interactive docs](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb)
- [GitHub repository](https://github.com/yetone/kill-ai-slop)

## Repository

- Repository: yetone/kill-ai-slop

- Generated: 2026-07-11T08:26:28.683Z
- Updated: 2026-07-11T08:27:01.780Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 18

## Pages

- [Overview](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/01-overview.md): What Kill AI Slop exposes: the agent skill, scanner entry points, shared catalogue, and field-guide site, plus who should use which surface first.
- [Installation](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/02-installation.md): Install the kill-ai-slop skill via npx or manual copy, and set up the Astro website dependencies for local development.
- [Quickstart](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/03-quickstart.md): Shortest path to a first scanner report and a local field-guide run, with expected success signals and one recovery note each.
- [Slop taxonomy](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/04-slop-taxonomy.md): Repo-specific model of AI-slop tells: categories, named signals, and how the field guide and skill share the same taxonomy language.
- [Catalogue model](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/05-catalogue-model.md): How catalogue.ts is the single source of truth for tells, how demos and i18n attach, and boundaries between site data and skill references.
- [Skill workflow](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/06-skill-workflow.md): Agent skill lifecycle: scan, triage, report, then propose or apply fixes without silent file edits from the standalone scanner.
- [Use the agent skill](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/07-use-the-agent-skill.md): Invoke kill-ai-slop inside a coding agent after install: prompts, expected host behavior, and how the skill uses references and the scanner.
- [Scan a web project](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/08-scan-a-web-project.md): Point the dependency-free scanner at a project path, interpret grouped vs JSON reports, and verify findings against detection rules.
- [Apply clean fixes](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/09-apply-clean-fixes.md): Map scanner hits to remediation steps from the fixes playbook, choose propose vs apply in an agent host, and confirm the clean alternative.
- [Run the field guide site](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/10-run-the-field-guide-site.md): Develop and preview the multilingual Astro field guide: install, dev server, static build output, and how entries and demos render on the index.
- [Extend the catalogue](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/11-extend-the-catalogue.md): Add or update a tell: catalogue entry, i18n strings, plain-HTML demo, and alignment with skill taxonomy, detection, and fix references.
- [Scanner CLI reference](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/12-scanner-cli-reference.md): Invocation, path argument, --json mode, walk/scan behavior, console formatting helpers, and hard constraint that the scanner never edits files.
- [Detection patterns](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/13-detection-patterns.md): Code-level signals the skill and scanner look for per tell: patterns, match targets, and how findings map back to taxonomy ids.
- [Remediation playbook](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/14-remediation-playbook.md): Per-tell clean fixes, what to remove or replace, and how before or after demos illustrate the preferred outcome.
- [Catalogue and demos data](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/15-catalogue-and-demos-data.md): Fields and shapes in catalogue.ts, catalogue.i18n.ts, and demos.ts: tell ids, copy locales, and demo HTML payloads used by site components.
- [Design tokens](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/16-design-tokens.md): Site self-constraints in tokens and global styles: paper and ink palette, single editorial red, hierarchy rules, and banned slop defaults.
- [Build and deploy](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/17-build-and-deploy.md): Static site build to dist, deploy-anywhere assumptions, and operational notes for the zero-JS-by-default Astro field guide.
- [Contributing](https://grok-wiki.com/public/docs/yetone-kill-ai-slop-c0d8c9670cbb/pages/18-contributing.md): Where to change skill references, scanner logic, catalogue data, or site components while keeping skill and website taxonomy aligned.

## Source Files

- `README.md`
- `skill/README.md`
- `skill/references/detection.md`
- `skill/references/fixes.md`
- `skill/references/taxonomy.md`
- `skill/scripts/scan.mjs`
- `skill/SKILL.md`
- `website/astro.config.mjs`
- `website/src/components/BeforeAfter.astro`
- `website/src/components/LangToggle.astro`
- `website/src/components/SlopEntry.astro`
- `website/src/components/T.astro`
- `website/src/components/ThemeToggle.astro`
- `website/src/data/catalogue.i18n.ts`
- `website/src/data/catalogue.ts`
- `website/src/data/demos.ts`
- `website/src/layouts/Base.astro`
- `website/src/pages/index.astro`
- `website/src/styles/demos.css`
- `website/src/styles/global.css`
- `website/src/styles/tokens.css`