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.