agent-add-rule

Analyze project structure to place agent governance rules in CLAUDE.md, docs/agents, or new skills.

16|15|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/ravnhq/ai-toolkit --skill agent-add-rule
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-add-rule
Source: https://github.com/ravnhq/ai-toolkit/tree/main/skills/agent-add-rule
Command: npx skills add https://github.com/ravnhq/ai-toolkit --skill agent-add-rule

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams correctly locate and integrate agent governance rules for Claude across root CLAUDE.md, topic-specific docs, or new skills.

Core Features & Use Cases

  • Analyzes the current project structure (root CLAUDE.md, docs/agents/, and available skills) to determine the correct placement (static, semi-dynamic, or fully dynamic).
  • Guides users through Step 3: classify a rule to root, docs/agents/, or a new skill.
  • Helps prevent duplication and ensures consistent routing signals and token costs.

Quick Start

Run the agent-add-rule skill to classify and place a new governance rule like "Always document assumptions" in the appropriate location.

Frequently Asked Questions about agent-add-rule

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decide where to place agent governance rules in CLAUDE.md?▼

To place agent governance rules in CLAUDE.md, you must analyze the project structure and rule frequency to decide whether a rule should be static, semi-dynamic, or a fully dynamic skill. This minimizes token costs and preserves routing signals.

What is the best way to organize Claude agent rules across docs and skills?▼

Organizing Claude agent rules requires classifying each rule by applicability and frequency to determine its correct location across root CLAUDE.md, topic-specific docs/agents, or a new skill. This prevents duplication and ensures consistent routing signals.

When should I create a new skill instead of adding rules to CLAUDE.md?▼

You should create a new skill instead of adding rules to CLAUDE.md when the governance rule is highly dynamic and specific, requiring fully dynamic execution rather than static or semi-dynamic documentation to minimize token cost.

How do I prevent duplicate agent rules in my project workflow?▼

To prevent duplicate agent rules in your project workflow, analyze the root CLAUDE.md and docs/agents directory to classify rule placement accurately. This classification framework ensures rules are integrated without duplication.

Does adding governance rules to CLAUDE.md increase token costs?▼

Adding static governance rules to CLAUDE.md can increase token costs if misallocated. The skill analyzes rule applicability and frequency to route rules to static, semi-dynamic, or dynamic locations, minimizing token cost and preserving routing signals.