Rule Creator

This skill guides through creating persistent rules — instructions that automatically apply to AI agent sessions, enforcing coding standards, project conventions, and file-specific patterns.

About Rules

Rules are markdown files with metadata that provide persistent context to AI agents. They differ from skills in that rules are automatically injected into every relevant session without explicit invocation.

Rules serve two purposes:

1. Always-apply rules — universal standards for every conversation (coding style, architecture decisions, project conventions)
2. Conditional rules — file-specific patterns triggered when matching files are open (TypeScript conventions for

   *.ts

   , React patterns for

   *.tsx

   )

IDE Detection and Rule Placement

Rules work across multiple IDEs but use different file formats and locations. Before creating a rule, determine the current environment.

Control Primitives Map by IDE

~/.claude/CLAUDE.md

~/.gemini/GEMINI.md

~/.codex/AGENTS.md

~/.codex/AGENTS.override.md

~/.config/opencode/AGENTS.md

~/.claude/CLAUDE.md

CLAUDE.md

.claude/rules/*.md

.agent/rules/*.md

AGENTS.md

.cursor/rules/*/RULE.md

.cursor/rules/*.mdc

AGENTS.md

AGENTS.override.md

AGENTS.md

CLAUDE.md

opencode.json

instructions

subdir/CLAUDE.md

CLAUDE.local.md

subdir/AGENTS.md

subdir/AGENTS.md

subdir/AGENTS.override.md

.claude/rules/*.md

.cursor/rules/*/RULE.md

.cursor/rules/*.mdc

opencode.json

instructions

~/.claude/commands/*.md

~/.gemini/antigravity/global_workflows/global-workflow.md

~/.cursor/commands/*.md

~/.codex/prompts/*.md

~/.config/opencode/commands/*.md

.claude/commands/*.md

.claude/commands/<namespace>/*.md

.agent/workflows/*.md

.cursor/commands/*.md

.opencode/commands/*.md

~/.claude/settings.json

~/.cursor/hooks.json

~/.config/opencode/plugins/*.{js,ts}

.claude/settings.json

.claude/settings.local.json

.cursor/hooks.json

.opencode/plugins/*.{js,ts}

settings.json

managed-mcp.json

~/.cursor/mcp.json

~/.codex/config.toml

opencode.json

mcp

.mcp.json

.cursor/mcp.json

opencode.json

mcp

.claude/settings.json

.gitignore

.cursorignore

.gitignore

.gitignore

.ignore

opencode.json

watcher.ignore

Rule-Specific Paths

.cursor/rules/*/RULE.md

alwaysApply: true

.cursor/rules/*/RULE.md

globs:

CLAUDE.md

.claude/rules/*.md

.claude/rules/*.md

paths:

.agent/rules/*.md

AGENTS.md

AGENTS.override.md

AGENTS.md

opencode.json

instructions

opencode.json

instructions

AGENTS.md

opencode.json

Detection Strategy

1. Check for IDE-specific markers in the project:

   • .cursor/

     directory -> Cursor

   • .claude/

     directory -> Claude Code

   • .opencode/

     directory or

     opencode.json

     -> OpenCode

   • .agent/

     directory -> Antigravity

   • .codex/

     directory or

     AGENTS.md

     without

     .cursor/

     -> OpenAI Codex
2. If multiple detected or none -> ask the user
3. Ask: always-apply or conditional (file-specific)?

Gather Requirements

Before creating a rule, determine:

1. Purpose: What should this rule enforce or teach?
2. Scope: Always apply, or only for specific files?
3. File patterns: If conditional, which glob patterns? (e.g.,

   **/*.ts

   ,

   backend/**/*.py

   )

Inferring from Context

If prior conversation context exists, infer rules from what was discussed. Create multiple rules if the conversation covers distinct topics. Don't ask redundant questions if context provides answers.

Required Questions

If scope not specified:

• "Should this rule always apply, or only when working with specific files?"

If file-specific but no concrete patterns:

• "Which file patterns should this rule apply to?"

Rule Format by IDE

Cursor

Directory-based rules in

.cursor/rules/<rule-name>/RULE.md

---
description: Brief description of what this rule does
globs: "**/*.ts"
alwaysApply: false
---

# Rule Title

Rule content here...

Legacy format (

.cursor/rules/*.mdc

description

alwaysApply: false

globs

alwaysApply

true

Claude Code

Rules in

.claude/rules/*.md

---
description: TypeScript conventions
paths: src/**/*.ts
---

# Rule Title

Rule content here...

Or project-wide in

CLAUDE.md

Antigravity

Rules in

.agent/rules/*.md

# Rule Title

Rule content here...

OpenAI Codex

Rules in

AGENTS.md

AGENTS.override.md

# Rule Title

Rule content here...

Subdirectory rules:

subdir/AGENTS.md

OpenCode

Always-apply rules in

AGENTS.md

# Rule Title

Rule content here...

Or via

opencode.json

instructions

{
  "instructions": [
    "AGENTS.md",
    ".cursor/rules/**/*.md",
    "https://example.com/standards.md"
  ]
}

Global user rules:

~/.config/opencode/AGENTS.md

~/.claude/CLAUDE.md

OPENCODE_DISABLE_CLAUDE_CODE_PROMPT=1

Core Principles

Keep Rules Concise

• Under 50 lines preferred, max 500 lines
• One concern per rule: split large rules into focused pieces
• Actionable: write like clear internal docs
• Concrete examples: show good/bad patterns with code

Structure

Every rule should contain:

1. Clear title — what aspect it covers
2. Brief context — why this rule exists (1-2 sentences max)
3. The rules themselves — concrete, actionable instructions
4. Examples — good/bad code patterns when applicable

Naming

• Cursor: directory name =

  kebab-case

  (e.g.,

  typescript-standards/RULE.md

  )
• Claude Code: filename =

  kebab-case.md

  (e.g.,

  typescript-standards.md

  )
• Others: section heading in the shared file

Rule Creation Process

Phase 1: Discovery

1. Determine IDE (auto-detect or ask)
2. Determine scope (always-apply vs conditional)
3. Determine file patterns if conditional
4. Gather the actual standards/conventions to encode

Phase 2: Implementation

1. Create the rule file in the correct location for the detected IDE
2. Write frontmatter with appropriate fields
3. Write concise, actionable rule content
4. Include concrete code examples (good/bad patterns)

Phase 3: Verification

Run validation:

scripts/validate_rule.py <path/to/rule-file-or-directory>

Checklist:

• Correct file format for target IDE
• Frontmatter configured correctly (description, globs/paths, alwaysApply)
• Content under 500 lines (prefer under 50)
• Includes concrete examples
• One concern per rule
• No redundancy with existing rules

Common Rule Categories

Example Rules

Error Handling (TypeScript)

---
description: TypeScript error handling standards
globs: "**/*.ts"
alwaysApply: false
---

# Error Handling

Always use typed errors with context:

\`\`\`typescript
// BAD
try {
  await fetchData();
} catch (e) {}

// GOOD
try {
  await fetchData();
} catch (e) {
  logger.error('Failed to fetch', { error: e });
  throw new DataFetchError('Unable to retrieve data', { cause: e });
}
\`\`\`

React Patterns

---
description: React component patterns
globs: "**/*.tsx"
alwaysApply: false
---

# React Patterns

- Use functional components
- Extract custom hooks for reusable logic
- Colocate styles with components
- Props interface named `{ComponentName}Props`

Project Architecture (Always Apply)

---
description: Core architecture rules
alwaysApply: true
---

# Architecture

- Domain logic in `src/domain/` — no framework imports
- API handlers in `src/api/` — thin, delegate to domain
- Shared types in `src/types/` — no runtime code