no_ai_slop_writing_rules/AGENTS.md

AGENTS.md

Guidelines for AI agents working in this repository.

Repository Overview

This repository publishes portable writing skills for AI agents. The installable skills live under skills/ and follow the Agent Skills directory shape:

skills/
├── no-ai-slop/
│   ├── SKILL.md
│   └── references/
└── rossmann-voice/
    └── SKILL.md

The .claude/skills/ directory is kept for Claude Code project-local use. Keep the skill content synchronized when changing either published skill.

Published Skills

• no-ai-slop: Rules and worked examples for writing prose that does not read like AI-generated slop.
• rossmann-voice: Louis Rossmann's writing voice for general prose.

Skill Format

Each skill requires a SKILL.md file with YAML frontmatter:

---
name: skill-name
description: What this skill does and when to use it.
---

Optional supporting material belongs beside the skill:

skills/skill-name/
├── SKILL.md
├── references/
├── scripts/
└── assets/

Manual Checks

• name must match the parent directory name.
• description should state what the skill does and when to use it.
• Keep large reference material in references/ so agents can load it on demand.
• Do not weaken the writing rules while changing the package format.