ad-rules

Load global CLAUDE.md or AGENTS.md rules and list their topics in conversation.

741|20|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-rules
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ad-rules
Source: https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime/tree/main/.agents/skills/ad-rules
Command: npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-rules

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Practitioners keep cross-project rules in a global CLAUDE.md or AGENTS.md file whose path varies per machine and is often a symlink, so every session starts with manually hunting down and re-reading that file. This Skill resolves the file, reports its real path, and restates the rule topics in the conversation so the conventions in force stay visible.

Core Features & Use Cases

  • Global rules resolution: Checks canonical host paths (~/.codex/AGENTS.md, ~/.claude/CLAUDE.md, and variants), resolves symlinks, and reports broken links as a distinct state.
  • Topic surfacing: Extracts topics from the global rules, repo binding docs (AGENTS.md, ARCHITECTURE.md, GUIDELINES.md, ADRs), and kit rule-set layers, ordered by binding force with the source file named per topic.
  • Conflict and staleness flags: Reports rules that shadow each other or cite files and commands that no longer exist, without modifying anything.
  • Use Case: You open a new repository and ask what conventions govern the work; the Skill locates your global rules file, lists its topics alongside the repo's binding docs, and flags one stale rule referencing a deleted script.

Quick Start

Ask the assistant to read your global CLAUDE.md or AGENTS.md and list the rule topics currently in force for this repository.

Frequently Asked Questions about ad-rules

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

FAQPage Schema
How do I load my global CLAUDE.md rules into a session?

Ask the assistant to read your global CLAUDE.md or AGENTS.md and list the topics in force. The Skill checks canonical host paths, resolves symlinks, and restates each rule topic with its source file.

Where does the Skill look for global rules files?

It checks ~/.codex/AGENTS.md, ~/.codex/instructions.md, ~/.claude/CLAUDE.md, and ~/.claude/AGENTS.md in that order. If none resolve, it searches the home directory for AGENTS*.md or CLAUDE.md files and presents candidates for you to pick.

What happens if my global rules file is a broken symlink?

A broken symlink is reported as its own state: found, target missing. This distinguishes a rules file you believe you still have from one that is genuinely absent, rather than silently treating it as nonexistent.

Does this Skill edit or audit my rules?

No. It is strictly read-only: it never edits a rule, never audits work against the rules, and never approves changes. Auditing belongs to ad-audit and rule changes to ad-level-up.

Can it fix a rules file that is not at a canonical path?

It prints the ln -s command to symlink the file into the host location but never runs it. Creating symlinks in your home directory requires your explicit approval and action.