audit-agents

Audits and generates AGENTS.md files against decentralized task management and conventions criteria.

6|Updated May 18, 2026
One-click install
npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill audit-agents-mokhtarabadi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-agents
Source: https://github.com/mokhtarabadi/cognitive-lead-hq/tree/main/skill-templates/audit-agents
Command: npx skills add https://github.com/mokhtarabadi/cognitive-lead-hq --skill audit-agents-mokhtarabadi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Projects using multi-agent AI workflows often lack consistent AGENTS.md governance files, or their existing files drift out of compliance with operational rules like Zero-Autonomous-Commit, Kanban task management, and defensive shell standards. This Skill audits existing AGENTS.md files against a strict criteria checklist or generates compliant ones from scratch. ## Core Features & Use Cases - Phase 0 Generation: Creates AGENTS.md and docs/conventions.md from templates for new projects, filling placeholders with detected tech stack details. - Audit & Patch Mode: Reads existing AGENTS.md read-only first, evaluates it against 20+ criteria (Kanban directories, MCP tool usage, Gatekeeper halt protocol, Lite Mode, gitignore rules), then patches gaps while preserving formatting. - Standards Enforcement: Ships templates for architecture.md, DESIGN.md, and conventions.md covering the Universal DateTime Standard, SOLID guidelines, Financial Ledger Standard, and Defensive Shell Protocol. - Use Case: Onboard a new repository to an orchestrated agent workflow by generating a compliant AGENTS.md, or audit an existing project to detect missing rules like the mandatory end-of-task sequence. ## Quick Start Audit the AGENTS.md file in this project against the audit-agents criteria and patch any missing operational rules.

Frequently Asked Questions about audit-agents

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

FAQPage Schema
How do I audit an AGENTS.md file for compliance?▼

Run the skill in Audit Mode: it reads AGENTS.md and docs/conventions.md read-only first, evaluates them against the Target Audit Criteria, then patches missing rules while preserving the existing Markdown structure and formatting.

How do I generate an AGENTS.md for a new project?▼

Use Phase 0 mode when no AGENTS.md exists. The skill reads your package configs and README to detect the tech stack, then generates AGENTS.md and docs/conventions.md from templates with project-specific details filled in.

What rules does the AGENTS.md audit check?▼

It verifies over 20 criteria including Kanban task directories, Zero-Autonomous-Commit, the 5-step end-of-task sequence, Gatekeeper halt protocol, Defensive Shell Protocol, Universal Financial Ledger Standard, Lite Mode protocol, and plugin runtime-state gitignore coverage.

Does the audit fail if DESIGN.md or architecture.md is missing?▼

No. The Absent-File Policy skips optional files like DESIGN.md and docs/architecture.md gracefully with an explicit note. The audit never halts, hallucinates their contents, or scaffolds them unless explicitly instructed.

Can the auditor modify files outside the project root?▼

No. Scope confinement is Priority 0: all file enumeration, inspection, and patching is strictly confined to the caller's working directory. Traversing parent directories or creating .opencode scaffolding in third-party projects is forbidden.