Skip to content

Commit befc299

Browse files
committed
feat: Add anti-slop skill for AI content quality control
Add comprehensive anti-slop skill for detecting and eliminating generic AI-generated patterns: - New skill directory: skills/anti-slop/ - SKILL.md: Main documentation with workflows - README.md: Overview and quick start guide - references/: Pattern catalogs for text, code, and design - text-patterns.md: Natural language slop patterns - code-patterns.md: Programming antipatterns - design-patterns.md: Visual/UX design slop patterns - scripts/: Python detection and cleanup tools - detect_slop.py: Automated slop detection (scoring 0-100) - clean_slop.py: Automated cleanup with safety features - Updated skills/_INDEX.md: - Added "Quality & Content Review" category (1 skill) - Added to discovery patterns by technology/task/domain - Added to skill combination examples - Added to quick reference table - Updated total skills count: 132 → 133 - Updated last modified date: 2025-10-23 - Updated CLAUDE.md: - Added anti-slop to skills catalog (132 → 133 total) - Added "Quality & Content Review" category - Added to quick category reference - Updated quality standards date Key features: - Detects overused AI phrases, buzzwords, meta-commentary - Identifies generic code patterns (variable names, comments) - Recognizes cookie-cutter design patterns - Provides automated text cleanup with backups - Comprehensive pattern catalogs for manual review - Cross-cutting quality improvement across all content types
1 parent 69ea8a7 commit befc299

9 files changed

Lines changed: 2453 additions & 9 deletions

File tree

CLAUDE.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -493,8 +493,8 @@ open https://ui.shadcn.com/themes
493493
**Old approach**: Monolithic skills `/zig-dev`, `/modal-dev` (too large)
494494
**New approach**: Atomic, composable skills (~300 lines avg, <500 line guideline)
495495

496-
### Quality Standards (as of 2025-10-18)
497-
- ✅ **132 skills** with YAML frontmatter (agent_skills_spec.md compliant)
496+
### Quality Standards (as of 2025-10-23)
497+
- ✅ **133 skills** with YAML frontmatter (agent_skills_spec.md compliant)
498498
- ✅ **0 future dates** - all dates validated by CI
499499
- ✅ **Automated testing** - code syntax validation in CI
500500
- 🔄 **Size optimization** - 89 skills >500 lines identified for splitting
@@ -531,15 +531,16 @@ Read zig-memory-management.md, zig-testing-patterns.md
531531
Read beads-workflow.md + beads-context-strategies.md + beads-multi-session-patterns.md
532532
```
533533

534-
### Skills Catalog (132 Total)
534+
### Skills Catalog (133 Total)
535535

536-
**Core Categories** (74 skills):
536+
**Core Categories** (75 skills):
537537
- **API Design** (7): REST, GraphQL, auth/authz, rate limiting, versioning, error handling
538538
- **Testing** (6): Unit, integration, e2e, TDD, coverage, performance testing
539539
- **Containers** (5): Dockerfile optimization, Compose, security, networking, registries
540540
- **Frontend** (8): React patterns, Next.js App Router, state/data/forms, a11y, performance, SEO
541541
- **Database** (11): Postgres (optimization, migrations, schema), MongoDB, Redis, Redpanda/Kafka streaming, Apache Iceberg, DuckDB analytics, pooling, ORMs, selection
542542
- **Workflow & Tasks** (5): Beads workflow, context strategies, multi-session, dependency management
543+
- **Quality & Content Review** (1): Anti-slop detection and cleanup (text, code, design)
543544
- **Meta Skills** (4): Skill discovery and planning for repositories and prompts
544545
- Discovery: `skill-repo-discovery.md` (analyze repos), `skill-prompt-discovery.md` (analyze prompts)
545546
- Planning: `skill-repo-planning.md` (plan repo skills), `skill-prompt-planning.md` (plan prompt skills)
@@ -578,6 +579,7 @@ DevOps/Infra: cicd/ (5) | infrastructure/ (6) | observability/ (5)
578579
Data: data/ (5) | realtime/ (4)
579580
Specialized: modal-*.md (8) | swiftui-*.md, swift-*.md, ios-*.md (6) | zig-*.md (6)
580581
Workflow: beads-*.md (4) | tui-*.md (5) | network-*.md (5)
582+
Quality: anti-slop/ (1 skill + 3 reference guides + 2 scripts)
581583
Meta: skill-*.md (5 including skill-creation.md)
582584
Formal: formal/z3-*.md, formal/sat-*.md, formal/smt-*.md (3) | formal/lean-*.md (4) | formal/csp-*.md (3)
583585
ML: ml/unsloth-*.md, ml/llm-*.md, ml/lora-*.md (4) | ml/diffusion-*.md (3)
@@ -601,7 +603,7 @@ Mobile: mobile/react-native-*.md (4)
601603
4. **Deep dive?** Search `skills/_INDEX.md` by technology/task/problem domain
602604
5. **Emergency?** Read relevant skill directly: `skills/api-*.md`, `skills/cicd/*.md`
603605

604-
**Full catalog**: `skills/_INDEX.md` (132 skills, workflows, search patterns, combinations)
606+
**Full catalog**: `skills/_INDEX.md` (133 skills, workflows, search patterns, combinations)
605607

606608
### Skill Quality Assurance
607609
All skills now include:

skills/_INDEX.md

Lines changed: 42 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,25 @@ This index catalogs all atomic skills available in the skills system, organized
128128

129129
---
130130

131+
### Quality & Content Review (1 skill)
132+
133+
| Skill | Use When | Lines |
134+
|-------|----------|-------|
135+
| `anti-slop/SKILL.md` | Detecting/eliminating AI-generated patterns (slop) in text, code, design; content quality review; preventing generic outputs | ~420 |
136+
137+
**Common workflows:**
138+
- Content review: Read `anti-slop/SKILL.md` → Run detection scripts → Apply cleanup → Manual review
139+
- Code cleanup: Read `anti-slop/references/code-patterns.md` → Identify patterns → Refactor
140+
- Design review: Read `anti-slop/references/design-patterns.md` → Audit against patterns → Recommendations
141+
142+
**Key features:**
143+
- Automated text slop detection and cleanup scripts
144+
- Comprehensive pattern catalogs for text, code, and design
145+
- Quality principles for authentic, non-generic content
146+
- Integration with development workflows
147+
148+
---
149+
131150
### Meta Skills (4 skills)
132151

133152
| Skill | Use When | Lines |
@@ -489,6 +508,7 @@ This index catalogs all atomic skills available in the skills system, organized
489508
**TUI (Rust):** Search `ratatui-*.md`, `tui-*.md`
490509
**Zig:** Search `zig-*.md`
491510
**Beads:** Search `beads-*.md`
511+
**Quality & Content:** `anti-slop/SKILL.md`, `anti-slop/references/*.md`
492512
**Meta Skills:** Search `skill-*.md`
493513
**CI/CD:** Search `cicd/*.md`, `github-*.md`, `ci-*.md`, `cd-*.md`
494514
**Infrastructure:** Search `infrastructure/*.md`, `terraform-*.md`, `aws-*.md`, `kubernetes-*.md`, `cloudflare-*.md`
@@ -528,6 +548,12 @@ This index catalogs all atomic skills available in the skills system, organized
528548
- iOS: `ios-testing.md`
529549
- Zig: `zig-testing.md`
530550

551+
**Content quality review:**
552+
- AI slop detection/cleanup: `anti-slop/SKILL.md`
553+
- Text patterns: `anti-slop/references/text-patterns.md`
554+
- Code patterns: `anti-slop/references/code-patterns.md`
555+
- Design patterns: `anti-slop/references/design-patterns.md`
556+
531557
**Networking:**
532558
- iOS: `ios-networking.md`
533559
- Secure: `mtls-implementation.md`, `tailscale-vpn.md`
@@ -571,6 +597,7 @@ This index catalogs all atomic skills available in the skills system, organized
571597
**API Development:** `rest-api-design.md`, `graphql-schema-design.md`, `api-authentication.md`, `api-rate-limiting.md`
572598
**DevOps/SRE:** `cicd/*.md`, `infrastructure/*.md`, `observability/*.md`, `cost-optimization.md`, `heroku-*.md`, `netlify-*.md`
573599
**Data Engineering:** `data/*.md`, `stream-processing.md`, `batch-processing.md`, `data-validation.md`
600+
**Content Quality:** `anti-slop/SKILL.md` (text, code, design quality review and cleanup)
574601
**Real-time Systems:** `realtime/*.md`, `websocket-implementation.md`, `server-sent-events.md`, `pubsub-patterns.md`
575602
**Formal Methods:** `formal/z3-*.md`, `formal/lean-*.md`, `formal/sat-*.md`, `formal/smt-*.md`, `formal/csp-*.md`
576603
**Machine Learning:** `ml/unsloth-*.md`, `ml/diffusion-*.md`, `ml/llm-*.md`, `ml/stable-diffusion-*.md`
@@ -738,6 +765,13 @@ This index catalogs all atomic skills available in the skills system, organized
738765
4. `skill-prompt-planning.md` - Plan missing skills from prompts
739766
5. `skill-creation.md` - Create new skills
740767

768+
### Content Quality Review
769+
1. `anti-slop/SKILL.md` - Understand slop patterns & workflows
770+
2. Run detection: `python scripts/detect_slop.py <file>`
771+
3. Review findings manually with reference guides
772+
4. Apply automated cleanup: `python scripts/clean_slop.py <file> --save`
773+
5. Manual refinement and verification
774+
741775
---
742776

743777
## Quick Reference Table
@@ -786,24 +820,28 @@ This index catalogs all atomic skills available in the skills system, organized
786820
| Find skills for prompt | skill-prompt-discovery.md | 1 |
787821
| Plan new skills | skill-repo-planning.md or skill-prompt-planning.md, skill-creation.md | 1→2 |
788822
| Create new skill | skill-creation.md | 1 |
823+
| Review content for AI slop | anti-slop/SKILL.md | 1 |
824+
| Clean up generic code | anti-slop/references/code-patterns.md | 1 |
825+
| Review design quality | anti-slop/references/design-patterns.md | 1 |
789826

790827
---
791828

792829
## Total Skills Count
793830

794-
- **132 atomic skills** across 27 categories
831+
- **133 atomic skills** across 28 categories
795832
- **Average 310 lines** per skill
796833
- **100% focused** - each skill has single clear purpose
797834
- **Cross-referenced** - related skills linked for discoverability
798835

799836
### By Category Breakdown
800-
**Core Foundation** (74 skills):
837+
**Core Foundation** (75 skills):
801838
- API Design: 7 skills
802839
- Testing: 6 skills
803840
- Containers: 5 skills
804841
- Frontend: 8 skills
805842
- Database: 11 skills
806843
- Workflow & Task Management: 5 skills
844+
- Quality & Content Review: 1 skill (anti-slop detection and cleanup)
807845
- Meta Skills: 4 skills (skill discovery and planning)
808846
- iOS/Swift: 6 skills
809847
- Modal.com: 8 skills (6 original + 2 troubleshooting)
@@ -849,6 +887,6 @@ See `MIGRATION_GUIDE.md` for detailed mapping.
849887

850888
---
851889

852-
**Last Updated:** 2025-10-18
853-
**Total Skills:** 129
890+
**Last Updated:** 2025-10-23
891+
**Total Skills:** 133
854892
**Format Version:** 1.0 (Atomic)

0 commit comments

Comments
 (0)