Anti-Flood - Claude Code Plugin

Prevent unnecessary file creation in Claude Code projects with modular SKILLs.

Anti-Flood - Claude Code Plugin

Version License: MIT SKILLs Status

Stop Claude from flooding your codebase with unnecessary files. Modular SKILLs for resource economy and contextual analysis.

⚠️ Beta Release: This plugin is in beta testing phase. Version 0.0.1-beta is fully functional but undergoing refinement based on real-world usage. External contributions are not accepted during beta - please open issues for discussion.

Quick Links

Installation • Features • How it Works • Documentation • Contributing

What is Anti-Flood?

A Claude Code plugin that prevents Claude from creating unnecessary files by enforcing smart file creation policies through modular SKILLs. Works automatically across all your projects with zero configuration.

Key Features:

  • 🛡️ Smart File Prevention - Blocks creation of documentation files unless explicitly requested
  • 💬 Chat-First Responses - Analysis and reviews delivered inline, not as files
  • 🎯 Contextual Analysis - Understands when files ARE needed (functional code, configs)
  • 🔧 Modular SKILLs - Three specialized optimizers (Skills, Agents, Commands)
  • ⚡ Zero Config - Install and it works everywhere automatically

Examples

Without anti-flood:

You: "Analyze this code"
Claude: *creates ANALYSIS.md, SUMMARY.md, REVIEW.md* (3 unnecessary files)

With anti-flood:

You: "Analyze this code"
Claude: *provides analysis in chat*
Claude: "Would you like me to save this analysis to a file?"

🎯 Problems Solved

Claude Code frequently:

  • ✗ Creates too many files (README.md, ANALYSIS.md, unsolicited examples)
  • ✗ Generates exaggerated and verbose descriptions
  • ✗ Returns to the same problems after refactoring
  • ✗ Implements "what could be" instead of what was requested

This SKILL corrects these behaviors through clear and self-applicable principles.

🚀 Installation

This plugin is available through the Claude Code Marketplace.

Via Marketplace (Recommended)

# Add marketplace (one time setup)
/plugin marketplace add angeloticiano/claude-marketplace

# Install anti-flood plugin
/plugin install anti-flood

Done! The plugin is now active in all your Claude Code projects.

Alternative: Direct Installation

# Install directly from GitHub
/plugin marketplace add angeloticiano/claude-anti-flood@main
/plugin install anti-flood

For Contributors: Manual Global Installation

If you want to modify the plugin or contribute:

# Clone and install globally
git clone https://github.com/angeloticiano/claude-anti-flood.git ~/.claude-anti-flood
cd ~/.claude-anti-flood

# Build SKILLs from principles/
./build-skill.sh      # Compiles principles/ → skills/*/SKILL.md

# Install to global Claude directory
./install-global.sh   # Copies to ~/.claude/skills/

The SKILL will be active in ALL your Claude Code projects. See CONTRIBUTING.md for details.

🔄 Updates

Plugin Installation

# Update to latest version
/plugin update anti-flood

Manual Installation

cd ~/.claude-anti-flood
git pull && ./build-skill.sh && ./install-global.sh

📋 Applied Principles

For SKILLs

  1. Composition without Duplication - Reuse via reference
  2. Resource Economy - Minimize tokens, files, iterations
  3. Activation Clarity - Define when to activate with precision

For Sub-Agents

  1. Single Specialization - One responsibility per sub-agent
  2. Contractual Interface - Well-defined input/output
  3. Lazy Invocation - Only call when necessary
  4. Stateless - No state between calls
  5. Graceful Errors - Never crash

For Slash Commands

  1. Separation of Responsibilities
  2. Tell, Don't Teach
  3. Simplify SubAgents
  4. Focused Scope

📁 Plugin Structure

anti-flood/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
├── principles/              # Source principles (edit here)
│   ├── base.md
│   ├── prevent-skill-bloat.md
│   ├── prevent-agent-bloat.md
│   ├── prevent-command-bloat.md
│   └── prevent-file-floods.md
├── skills/                  # Compiled SKILLs
│   ├── prevent-file-floods/
│   ├── prevent-skill-bloat/
│   ├── prevent-agent-bloat/
│   └── prevent-command-bloat/
├── examples/                # Usage examples
│   ├── code-review.md
│   ├── feature-implementation.md
│   └── debugging.md
├── build-skill.sh           # Compiles SKILLs
├── install-global.sh        # Installs to ~/.claude/skills/
├── CHANGELOG.md             # Version history
├── CONTRIBUTING.md          # Developer guide
├── LICENSE                  # MIT license
└── CLAUDE.md                # Technical documentation

🛠️ How It Works

  1. Principles in principles/ define behaviors
  2. build-skill.sh compiles everything into a single SKILL.md
  3. install-global.sh copies to ~/.claude/skills/anti-flood/
  4. Claude Code automatically loads from ~/.claude/skills/ in ALL projects

✅ Validation

SKILL self-validates before creating resources:

  • Violating any principle?
  • Creating more than requested?
  • Being unnecessarily verbose?
  • Adding possibilities to deterministic cases?

Warns: ⚠️ "This may violate [principle X] - confirm?"

🔍 Standard Workflow

Code Analysis

  1. Analysis in chat (not in file)
  2. Improved code in blocks
  3. Ask: "Create file with improved version?"

Implementation

  1. Plan in chat
  2. Create only functional files
  3. Ask: "Additional documentation?"

Debug

  1. Identify in chat
  2. Explain in chat
  3. Show correction
  4. Ask: "Create corrected file?"

📖 Complete Documentation

See CLAUDE.md for:

  • Detailed architecture
  • Decision keywords
  • Usage examples
  • Troubleshooting

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for:

  • How to modify principles and rebuild SKILLs
  • Testing locally before submitting PRs
  • Code style and conventions
  • Release process

📄 License

MIT