# Creating Claude Rules

> Use when creating or fixing .claude/rules/ files - provides correct paths frontmatter (not globs), glob patterns, and avoids Cursor-specific fields like alwaysApply

- **Type:** Skill
- **Install:** `agentstack add skill-agentworkforce-relay-creating-claude-rules-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AgentWorkforce](https://agentstack.voostack.com/s/agentworkforce)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [AgentWorkforce](https://github.com/AgentWorkforce)
- **Source:** https://github.com/AgentWorkforce/relay/tree/main/.claude/skills/creating-claude-rules-skill
- **Website:** https://agentrelay.com

## Install

```sh
agentstack add skill-agentworkforce-relay-creating-claude-rules-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 omit paths for global rules
# (no frontmatter needed)
```

```yaml
# ❌ WRONG - unquoted patterns
---
paths:
  - **/*.ts
---

# ✅ CORRECT - quote glob patterns
---
paths:
  - "**/*.ts"
---
```

## Directory Structure

```
.claude/rules/
├── testing.md          # Path-scoped or global
├── typescript.md
└── frontend/           # Subdirectories supported
    └── react.md
```

Files discovered recursively. Use subdirectories to organize.

## Glob Patterns

| Pattern             | Matches                |
| ------------------- | ---------------------- |
| `**/*.ts`           | All .ts files anywhere |
| `src/**/*`          | Everything under src/  |
| `*.md`              | Markdown in root only  |
| `**/*.{ts,tsx}`     | .ts and .tsx files     |
| `{src,lib}/**/*.ts` | .ts in src/ or lib/    |

## Reference

https://code.claude.com/docs/en/memory#modular-rules-with-claude/rules/

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AgentWorkforce](https://github.com/AgentWorkforce)
- **Source:** [AgentWorkforce/relay](https://github.com/AgentWorkforce/relay)
- **License:** Apache-2.0
- **Homepage:** https://agentrelay.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-agentworkforce-relay-creating-claude-rules-skill
- Seller: https://agentstack.voostack.com/s/agentworkforce
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.