0/2000

Try an example:

How It Works

1

Describe Your Functionality

Tell us what you want your AI agent to do — coding standards, workflows, review processes, or any behavioral instructions.

2

AI Analyzes Your Description

Our AI evaluates factors like reusability, scope, persistence needs, and task-specificity to determine the best placement.

3

Get a Recommendation + Markdown

Receive an instant recommendation (skill.md or agents.md) with reasoning and ready-to-use markdown content you can copy or download.

skill.md vs agents.md — When to Use Each

🎯 skill.md

A standalone file loaded on demand for specific tasks. Best for:

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

📋 agents.md / CLAUDE.md

Persistent instructions always active for your agent. Best for:

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

Popular Guides

How to Use Claude Code

Complete guide to getting started with Claude Code for AI-assisted development.

Claude Code Extensions

Discover extensions that supercharge Claude Code for specific workflows.

Claude Code Skills

Learn how to use skill.md files to create reusable workflows and instructions.

Claude Code Configuration

Setup and configure Claude Code for optimal performance in your projects.

Claude Code vs Alternatives

Claude Code vs GitHub Copilot

Compare AI coding assistants: features, strengths, and when to choose each.

agents.md vs claude.md

Understand the difference between project-level and agent-level configuration files.

Frequently Asked Questions

What is the difference between skill.md and agents.md?▾
A skill.md is a standalone, reusable instruction file loaded on demand for specific tasks (e.g., debugging, code review). agents.md or CLAUDE.md contains persistent instructions that are always active — like coding standards, project conventions, or deployment rules the agent needs for every interaction.
When should I use a skill.md file?▾
Use skill.md when the functionality is task-specific, can be reused across projects, is loaded only when needed, or represents a discrete workflow like TDD, security review, or performance optimization.
When should I put instructions in agents.md or CLAUDE.md?▾
Use agents.md or CLAUDE.md for persistent rules that should always be active — project conventions, coding standards, deployment procedures, team workflows, or any instruction the AI agent needs for every interaction with your codebase.
Is ClaudeOrNot free to use?▾
Yes, ClaudeOrNot is completely free. Describe your agent functionality and get an instant recommendation with generated markdown content you can copy or download.
What AI models does ClaudeOrNot use?▾
ClaudeOrNot uses advanced AI models via OpenRouter to analyze your description and provide accurate recommendations for skill.md vs agents.md placement.