ruler

Fan out Markdown rules to multiple AI agents via local and global configurations.

Updated May 21, 2025
One-click install
npx skills add https://github.com/jonparkdev/nix-config --skill ruler-jonparkdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ruler
Source: https://github.com/jonparkdev/nix-config/tree/main/ai/skills/ruler
Command: npx skills add https://github.com/jonparkdev/nix-config --skill ruler-jonparkdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ruler provides a single source of truth for AI agent instructions by centralizing rules in Markdown and distributing them to each configured agent's native config format.

Core Features & Use Cases

  • Centralized rule authoring: write rules once in Markdown and fan them out to all agents.
  • Local and global configurations: supports per-project rules and global defaults.
  • Safe apply/revert workflow: run changes with previews and undo with backups.

Quick Start

Initialize ruler in your project and run ruler apply to fan the rules to all configured agents.

Frequently Asked Questions about ruler

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

FAQPage Schema
How do I manage AI agent rules across multiple tools without duplicating instructions?

Yes, you can distribute rules globally by configuring ruler defaults that apply across all projects, or locally by setting per-project rules. This flexibility allows you to maintain global standards while overriding specifics for individual project scopes.

How do I apply AI agent configuration changes and safely revert them if needed?

To apply AI agent configuration changes safely, use the ruler apply command which provides previews before execution and creates backups. This safe apply/revert workflow lets you undo changes easily if the distributed rules cause issues.

Does ruler work with different AI agent config formats using a single Markdown source?

To initialize centralized rule distribution, create a root SKILL.md file with YAML frontmatter containing name and description, optionally include scripts, references, and assets directories, then run ruler apply to fan the rules to all configured agents.

Can I use Markdown to configure both local and global rules for multiple AI agents?

Yes, you can use Markdown to configure both local and global rules for multiple AI agents. Ruler supports per-project rules and global defaults, allowing you to maintain consistent instructions across different project scopes from a single Markdown source.