rulecheck
Autonomous rule adherence checker. Scans the codebase for rule violations, fixes the highest-impact ones in an isolated worktree, runs full validation, creates a PR. Uses memory to track progress across runs.
- Installs
- 277
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/coleam00/archon --skill rulecheck- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads rulecheck automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Rulecheck
Launch the rulecheck-agent to autonomously scan and fix AGENTS.md rule violations.
Your Job (Main Agent)
You are the orchestrator. Your ONLY job is to launch the rulecheck-agent and report its results when it completes. You do NOT do the scanning or fixing yourself.
- Launch the rulecheck-agent with the focus area (if any):
$ARGUMENTS - Wait for it to complete — do NOT poll, tail, or check on it. You will be notified automatically when it finishes.
- Report ONLY what the agent told you — relay its final message verbatim or summarize it. Do NOT search for PRs, read files, or fabricate results. If the agent hit its context limit, say so. If it didn't produce a PR URL in its output, don't go looking for one.
Rules for You
- Do NOT scan the codebase yourself — that's the agent's job
- Do NOT grep, read source files, or run linters — the agent handles all of that
- Do NOT edit any files — you are the orchestrator, not the fixer
- Do NOT try to resume or check on the agent while it's running — just wait
- Do NOT do the agent's work if it fails or hits context limits — report the failure to the user and stop. NEVER pick up where the agent left off. You are not in a worktree and would be editing main directly.
- Do NOT update project memory — the agent maintains its own memory at
.claude/agent-memory/rulecheck-agent/. Do not duplicate run results into your project memory. - Trust the agent. It runs in an isolated worktree and will create a PR when done.
FAQ
What does the rulecheck skill do?
Autonomous rule adherence checker. Scans the codebase for rule violations, fixes the highest-impact ones in an isolated worktree, runs full validation, creates a PR. Uses memory to track progress across runs.
How do I install rulecheck?
Run npx skills add https://github.com/coleam00/archon --skill rulecheck in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/rulecheck/ (personal) or .claude/skills/rulecheck/ (project).
Which AI agents can use rulecheck?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is rulecheck safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains rulecheck?
It is published by coleam00 in coleam00/archon. It has 277 recorded installs.
More from coleam00/archon
playwright-cli
coleam00/archon
Automate browser interactions, test web pages and work with Playwright tests.
docker-extend
coleam00/archon
Use when: User wants to extend Docker with custom tools, personalize the Docker environment, or set up user-specific Docker customization. Triggers: 'extend docker', 'docker-extend', 'add tools to docker', 'customize docker', 'add my tools to the container', 'personalize docker setup', 'docker user setup', 'install tools in docker'. Does: Interactively sets up Dockerfile.user and docker-compose.override.yml so users can add personal tools to their Docker environment without affecting maintainer files or committing user-specific config to git.
test-release
coleam00/archon
Open the skill to read its SKILL.md instructions.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.