Agent skill

Audit Agent Rules

by serejaris in serejaris/personal-corp-os

Audits the agent rules in the current folder (AGENTS.md, nested AGENTS.md files) and the skill descriptions the agent sees at start, then reports what to cut, move or rewrite and edits only after…

MITAuto-check passedAgent Workflows

Install Audit Agent Rules

skills CLI
$ npx skills add serejaris/personal-corp-os --skill audit-agent-rules -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install serejaris/personal-corp-os audit-agent-rules --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/serejaris/personal-corp-os.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/audit-agent-rules .claude/skills/audit-agent-rules && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
audit-agent-rules
GitHub stars
229
Token cost
~2.3k tokens
SKILL.md length
1,067 words
Files
5 (incl. scripts, references)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Audits the agent rules in the current folder (AGENTS.md, nested AGENTS.md files) and the skill descriptions the agent sees at start, then reports what to cut, move or rewrite and edits only after…

  • Works in 4 steps: Каждая строка правил: маршрут, граница… → Файл до 200 строк. Ориентир Anthropic:… → AGENTS.md работает навигатором. Детали… → …
  • Tasks that involve Agent instruction files
  • SKILL.md covers Что проверяется, Четыре мерила, Порядок работы and Шаблон отчёта, plus 2 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Audit Agent Rules is an agent skill from serejaris/personal-corp-os. Audits the agent rules in the current folder (AGENTS.md, nested AGENTS.md files) and the skill descriptions the agent sees at start, then reports what to cut, move or rewrite and edits only after the user says yes. Use on «аудит правил», «проверь AGENTS.md», «почему агент не слушается правил», «проверь скиллы».

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `README.md`, `README.ru.md` and `references/where-lines-go.md`).

It sits in Agent Workflows, covering Agent instruction files. The repository describes itself as: Personal Corp OS — управление личной компанией через AI-агентов: задачи вне головы, отделы вместо памяти, недельное ретро. Открытые скиллы для Claude Code и Codex. The licence is MIT.

When your agent uses it

  • Tasks that involve Agent instruction files

Example prompts

  • “Use the audit-agent-rules skill to audit the agent rules in the current folder (AGENTS.md, nested AGENTS.md files) and the skill descriptions the…”
  • “/audit-agent-rules”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Каждая строка правил: маршрут, граница или постоянное поведение.
  2. Файл до 200 строк. Ориентир Anthropic: длинный файл занимает контекст, и агент хуже соблюдает правила. Codex читает все AGENTS.md от корня…
  3. AGENTS.md работает навигатором. Детали лежат в своих файлах и скиллах, в правилах остаётся строка-маршрут: «Для X открой Y» или «X пиши…
  4. Описание скилла отвечает на вопрос «когда меня брать». Поле description говорит, что скилл делает, и когда его брать или по каким фразам…

What it can do on your machine

Read from SKILL.md and the folder at commit 95e36c3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • code.claude.com
    • learn.chatgpt.com
    • anthropic.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Audit Agent Rules loads about 2.3k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 1,067 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from serejaris/personal-corp-os at commit 95e36c3, republished under its MIT licence (© serejaris). 1,067 words, ~2,274 tokens.

Download SKILL.mdSave it as .claude/skills/audit-agent-rules/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
audit-agent-rules
description
Audits the agent rules in the current folder (AGENTS.md, nested AGENTS.md files) and the skill descriptions the agent sees at start, then reports what to cut, move or rewrite and edits only after the user says yes. Use on «аудит правил», «проверь AGENTS.md», «почему агент не слушается правил», «проверь скиллы».

Аудит правил агента

Скилл проверяет файлы правил агента в текущей папке и каталог скиллов, который агент видит на старте. Отдаёт отчёт таблицей: что не так и как сделать лучше. Файлы меняет только после «да» человека.

Скилл обычно зовёт человек без опыта в программировании: он ведёт папку с агентом для своей работы. Отчёт пиши простыми словами, на языке человека; термин объясняй один раз через то, что он меняет в работе агента.

Что проверяется

  • AGENTS.md в текущей папке и во всех её подпапках. Его читают Claude Code, Codex, Cursor и другие агенты, поэтому аудит строится вокруг него.
  • CLAUDE.md, CLAUDE.local.md и .claude/rules/ попадают в отчёт одной находкой, если в них свой текст: тогда Claude Code читает одни правила, остальные агенты другие. Разбирать их построчно не нужно.
  • Скиллы из .agents/skills и .claude/skills этой папки (и папок выше до корня git-репозитория), ~/.agents/skills, ~/.codex/skills, ~/.claude/skills.

Четыре мерила

  1. Каждая строка правил: маршрут, граница или постоянное поведение.

    ВидЧто делаетПример
    МаршрутВедёт к файлу или скиллу под задачу«Пост в канал пиши через скилл telegram-post»
    ГраницаЧто можно и что нельзя«archive/ только читать»
    Постоянное поведениеДействует на любой запрос«Отвечай по-русски, коротко»

    Строка другого вида уходит из файла: процедура с шагами в скилл или docs/, история решений в git, справка в docs/, правило одной подпапки во вложенный AGENTS.md. Проверка строки: если её удалить, агент ошибётся? Если нет, строка лишняя.

  2. Файл до 200 строк. Ориентир Anthropic: длинный файл занимает контекст, и агент хуже соблюдает правила. Codex читает все AGENTS.md от корня репозитория до папки, где его запустили, в общий бюджет 32 KiB (32 768 байт в UTF-8). Кириллическая буква весит 2 байта. Что не влезло, Codex обрезает и не читает.

  3. AGENTS.md работает навигатором. Детали лежат в своих файлах и скиллах, в правилах остаётся строка-маршрут: «Для X открой Y» или «X пиши через скилл Z». Вложенный AGENTS.md агент гарантированно читает только в сессии, начатой в его папке, поэтому у каждого вложенного файла есть маршрут из корневого.

  4. Описание скилла отвечает на вопрос «когда меня брать». Поле description говорит, что скилл делает, и когда его брать или по каким фразам. Оно короткое и не пересекается с описаниями других скиллов. Каталог описаний агент видит на старте целиком, тело скилла читает по требованию. У Codex стартовый список скиллов ограничен 2% окна контекста (8 000 символов, если окно неизвестно): при переборе он сокращает описания, и часть скиллов выпадает из списка. Claude Code обрезает описание одного скилла после 1 536 символов.

Порядок работы

  1. Замерить. Запусти сканер из папки этого скилла: python3 <папка скилла>/scripts/scan.py . Он только читает и печатает разделы: файлы правил со строками и байтами, CLAUDE.md и .claude/rules, цепочки Codex, вложенные файлы без маршрута, подсказки по строкам, каталог скиллов, маршруты в никуда. Всё, что он нашёл, кандидаты: каждое срабатывание ты подтверждаешь чтением. Если Python нет, посчитай то же вручную. Готово, когда прочитан весь вывод.

  2. Отделить правила папки от образцов. Рабочий файл подпапки (правила, по которым агент работает в ней) разбирается построчно. Образец для другой папки (шаблон, раздатка, архив, пример в материалах) идёт в отчёт одной строкой «образец, построчно не разбирал». Агент всё равно подгружает образец, когда работает в его папке; если это мешает, скажи об этом в той же строке.

  3. Разметить строки. Прочитай корневой AGENTS.md и каждый вложенный файл правил целиком. Каждой строке дай вид из мерила 1 или пометку «уходит» с местом назначения по references/where-lines-go.md. Подсказки сканера (история, шаги, код, длинная строка) показывают, куда смотреть первым делом; решение по строке за тобой. Попутно отметь дубли между файлами, противоречия и маршруты на несуществующие файлы, папки и скиллы. В противоречии выбирает человек: в правке назови оба варианта и спроси, какой оставить. Готово, когда размечена каждая строка каждого рабочего файла правил.

  4. Проверить маршруты. Для каждого вложенного AGENTS.md найди в корневом строку, которая к нему ведёт. Сканер ищет в тексте путь вида папка/AGENTS.md: найденная строка должна быть маршрутом и называть задачу, а маршрут, который называет только папку, проверь глазами. Цепочку Codex больше 32 768 байт назови с местом обрезки.

  5. Проверить каталог описаний. Сверь сумму символов с 8 000: у модели с большим окном бюджет больше, но сумма в разы выше 8 000 значит, что Codex сокращает описания. Прочитай каждое описание: есть ли «что делает» и «когда брать». Пары из таблицы похожих описаний прочитай и реши, пересекаются ли они по задаче. Отдельно отметь копии одного скилла в нескольких папках и битые ссылки. Скиллы плагинов и встроенные скиллы сканер не видит: напиши это одной строкой в отчёте.

  6. Отчёт. По шаблону ниже. Сначала то, чего агент не видит совсем (обрезка Codex, нет маршрута, два набора правил), потом строки не своего вида, потом скиллы. В таблице до 15 строк с самым большим эффектом, остальное коротко в «Ещё». Скилл из домашней папки помечай «общий для всех папок».

  7. Спросить «Переписать?». Дальше ничего не меняй, пока человек не ответил «да» или не назвал номера строк таблицы.

  8. Переписать. До первой правки сохрани исходники: в git-репозитории проверь, что изменения человека закоммичены или он согласен работать поверх них; без git скопируй файлы в rules-backup-ГГГГ-ММ-ДД/. Переноси по references/where-lines-go.md. Каждая уходящая строка появляется в новом месте до удаления из старого. Скиллы в домашней папке (~/…) общие для всех папок человека: правь их, только если он назвал их в ответе. Скилл из плагина не правь, предложи отключить плагин.

  9. Перемерить и проверить смоуком. Запусти сканер снова и покажи числа «было → стало». Попроси человека открыть новую сессию агента в этой папке и спросить: «Не открывая файлов, назови правило из AGENTS.md про <тема>». Для вложенного файла новую сессию открывают в его подпапке. Для скилла человек пишет фразу из описания и смотрит, взял ли агент нужный скилл. Агент не назвал правило: найди, почему оно не доходит, и почини.

Show full SKILL.md (141 more words)Show less

Шаблон отчёта

markdown
**Итог.** Файлов правил: 4, строк: 312, байт: 21 480. Самая длинная цепочка Codex: 21 480 из 32 768 байт. Скиллов в каталоге: 23, описания: 9 100 символов при ориентире Codex 8 000.

| # | Где | Что не так | Мерило | Что сделать |
|---|---|---|---|---|
| 1 | `docs/AGENTS.md` | Из корня нет маршрута: агент, запущенный в корне, этих правил не видит | 3 | В корневой `AGENTS.md` строку «Правила документации: `docs/AGENTS.md`» |
| 2 | `AGENTS.md:40–58` | Процедура из 9 шагов: как выпускать пост | 1 | В скилл `post`; в файле строка «Пост выпускай через скилл `post`» |
| 3 | `AGENTS.md:12` | История: «решили на созвоне 12.03» | 1 | Удалить, история в git |
| 4 | скилл `report` и `weekly-report` | Описания про одно: «отчёт за неделю» | 4 | `report` оставить для разовых отчётов, `weekly-report` для недели; переписать оба |

Ещё: `CLAUDE.md` в корне со своим текстом, Claude Code и Codex читают разные правила. Скиллы плагинов не проверял.

Переписать? Ответь «да», номерами строк таблицы или «нет».

Каждая строка таблицы называет файл и строку, проблему простыми словами, номер мерила и конкретную правку: куда перенести или как переписать. Строка без конкретной правки или вопроса с вариантами в отчёт не идёт.

Границы

  • До «да» скилл только читает.
  • Новых правил от себя в файл не добавляй: аудит переносит и переписывает то, что уже есть. Если правила явно не хватает, предложи его отдельной строкой отчёта.
  • Глобальные файлы правил харнесов (~/.claude/CLAUDE.md, ~/.codex/AGENTS.md) упомяни в отчёте, если они длинные или спорят с правилами папки; правь их только по прямой просьбе.
  • Жёсткий запрет, который нельзя доверить модели (не пушить, не удалять), предложи поставить в настройки агента; строка в файле правил остаётся пояснением.

Источники

© serejaris, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/audit-agent-rules of serejaris/personal-corp-os.

  • SKILL.md
  • README.md
  • README.ru.md
  • references/where-lines-go.md
  • scripts/scan.py

Open the folder on GitHubat commit 95e36c3

Compare with similar skills

Audit Agent Rules next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Audit Agent Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Audit Agent Rules this skillserejaris/personal-corp-os229—~2.3kAutomated safety check: PassMIT
Using Agent Skillsaddyosmani/agent-skills103k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.7k2 repos~627Automated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Writing For Agentsbestofjs/bestofjs3.1k18 repos~2.7kAutomated safety check: PassMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    103k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed
  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.7k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 18 repos~2.7k tokens
    Agent WorkflowsAuto-check passed
  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed
  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from serejaris/personal-corp-os

All 36 skills in this repo
  • Weekly Planning

    serejaris/personal-corp-os

    A skill your agent uses when the user is transitioning from a completed retro into a weekly plan, choosing weekly outcomes, scheduling a full ISO week, or asking for "план на неделю", "weekly…

    229 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Gh Issues

    serejaris/personal-corp-os

    A skill your agent uses when creating, searching, updating, or managing GitHub issues via CLI.

    229 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Product Data Audit

    serejaris/personal-corp-os

    A skill your agent uses when auditing a product, business, or project ecosystem — analyzing data sources, decision loops, bottlenecks, and implementation contours.

    229 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Tg Bot Ops

    serejaris/personal-corp-os

    A skill your agent uses when operating, debugging, deploying, or monitoring a Telegram bot or Telegram-to-agent gateway.

    229 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes
  • Make Landing

    serejaris/personal-corp-os

    Создаёт несколько вариантов дизайна 2D-поверхности (лендинг, герой, обложка, слайды): свой визуальный референс и автор на вариант, полный design.md с UTC/SHA-256 до кода, проверка в браузере…

    229 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Safe Public Release

    serejaris/personal-corp-os

    A skill your agent uses when publishing, open-sourcing, exporting, sanitizing, or moving code, agent skills, prompts, templates, fixtures, datasets, workshop assets, or other artifacts from a…

    229 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check: notes

Categories

Questions about Audit Agent Rules

What does Audit Agent Rules do?

Audits the agent rules in the current folder (AGENTS.md, nested AGENTS.md files) and the skill descriptions the agent sees at start, then reports what to cut, move or rewrite and edits only after…. Audit Agent Rules is an agent skill from serejaris/personal-corp-os.md files) and the skill descriptions the agent sees at start, then reports what to cut, move or rewrite and edits only after the user says yes.

When should I use Audit Agent Rules?

Audit Agent Rules fits situations like: tasks that involve Agent instruction files.

How do I install Audit Agent Rules in Claude Code?

Run `npx skills add serejaris/personal-corp-os --skill audit-agent-rules -a claude-code`. Or copy the skill folder (skills/audit-agent-rules in serejaris/personal-corp-os) into .claude/skills/audit-agent-rules in your project. Claude Code loads it when a task matches its description.

How do I install Audit Agent Rules in Codex?

Run `npx skills add serejaris/personal-corp-os --skill audit-agent-rules -a codex`. Or copy the skill folder (skills/audit-agent-rules in serejaris/personal-corp-os) into .agents/skills/audit-agent-rules in your project. Codex loads it when a task matches its description.

Can I use Audit Agent Rules in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add serejaris/personal-corp-os --skill audit-agent-rules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/audit-agent-rules, .gemini/skills/audit-agent-rules, .github/skills/audit-agent-rules and .opencode/skills/audit-agent-rules in your project.

What does Audit Agent Rules need to run?

Going by SKILL.md and its folder, Audit Agent Rules needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Audit Agent Rules access the network?

SKILL.md names 3 domains. As links in the text: code.claude.com, learn.chatgpt.com and anthropic.com. This is read from the text; nothing was executed.

Is Audit Agent Rules safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Audit Agent Rules use?

Audit Agent Rules is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Audit Agent Rules use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Audit Agent Rules?

Skills that share tags, products or a category with Audit Agent Rules: Using Agent Skills (addyosmani/agent-skills, 103k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.7k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars) and Writing For Agents (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Audit Agent Rules?

serejaris (a GitHub user) maintains it in serejaris/personal-corp-os, which has 229 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 7, 2026.

Source: serejaris/personal-corp-os on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.