creating-claude-rules

npx skills add AgentWorkforce/relay --skill creating-claude-rules-skill --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Creating Claude Rules ## Overview Rules in `.claude/rules/` are modular instructions scoped to specific files via glob patterns. They load automatically with same priority as `CLAUDE.md`. ## When to Use - Creating new rules in `.claude/rules/` - Fixing rules that use wrong frontmatter (`globs` instead of `paths`) - Migrating Cursor rules to Claude format - Organizing project-specific conventions ## Quick Reference | Field | Claude | Cursor | | ------------- | -------------- | ------------------- | | Path patterns | `paths` | `globs` | | Always apply | Omit `paths` | `alwaysApply: true` | | Description | Not documented | `description` | ## Frontmatter ### Path-Scoped Rules ```yaml --- paths: - 'src/api/**/*.ts' - 'tests/**/*.test.ts' --- ``` Or single pattern: ```yaml --- paths: src/**/*.{ts,tsx} --- ``` ### Global Rules Omit frontmatter entirely - applies to all files: ```markdown # TypeScript Conventions Use .js extensions in imports. ``` ## Common Mistakes ```yaml # ❌ WRONG - globs is Cursor format --- globs: - '**/*.ts' --- # ✅ CORRECT - Claude uses paths --- paths: - '**/*.ts' --- ``` ```yaml # ❌ WRONG - alwaysApply is Cursor-only --- alwaysApply: true --- # ✅ CORRECT - just