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
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.