About ClaudeOrNot

ClaudeOrNot is a free tool that helps developers configure AI coding agents. When you're setting up an agent like Claude Code, Cursor, or Windsurf, you need to decide where to put your instructions: in a reusable skill.md file or in the always-active agents.md / CLAUDE.md.

This choice matters. Put project conventions in a skill file and your agent won't follow them consistently. Put a one-off workflow in agents.md and you bloat the context for every session. ClaudeOrNot analyzes your description and gives you a clear recommendation with ready-to-use markdown output.

How It Works

  1. 1Describe what you want your AI agent to do — coding standards, workflows, review processes, or any behavioral instructions.
  2. 2Our AI evaluates factors like reusability, scope, persistence needs, and task-specificity to determine the best placement.
  3. 3Get an instant recommendation (skill.md or agents.md) with reasoning and ready-to-use markdown content you can copy or download.

When to Use Each

skill.md

  • • Reusable workflows across projects
  • • Task-specific instructions (TDD, security review)
  • • Loaded only when needed
  • • Discrete, self-contained capabilities

agents.md / CLAUDE.md

  • • Project coding standards & conventions
  • • Always-on rules (commit format, deploy steps)
  • • Project-specific configuration
  • • Team-wide behavioral expectations

Why ClaudeOrNot?