audit-protocol-compliance

Audit session conversations for task protocol compliance violations and generate a JSON report with remediation suggestions.

4|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/cowwoc/styler --skill audit-protocol-compliance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-protocol-compliance
Source: https://github.com/cowwoc/styler/tree/main/.claude/skills/audit-protocol-compliance
Command: npx skills add https://github.com/cowwoc/styler --skill audit-protocol-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, git.

What problem does it solve?

AI agents, like human developers, can inadvertently deviate from established task protocols, leading to critical violations (e.g., skipping user approvals, main agent directly implementing code) that compromise quality, security, or workflow integrity. Manually auditing complex conversations for these subtle violations is time-consuming, subjective, and prone to oversight. This Skill automates the compliance check.

Core Features & Use Cases

  • Systematic Compliance Checks: Automatically audits conversation sessions against a comprehensive set of protocol rules (e.g., user approval, worktree isolation, agent delegation, state transitions).
  • Evidence-Based Reporting: Provides clear, objective verdicts for each check, citing specific timeline evidence (timestamps, tool uses, actors) for any violations.
  • Documentation Fix Recommendations: Suggests concrete changes to protocol documentation to prevent future recurrences of identified violations, fostering continuous improvement.
  • Use Case: After an agent completes a task, you need to verify it followed all mandatory steps, such as getting user approval after the SYNTHESIS phase. This Skill automatically scans the conversation, flags any missed approvals as CRITICAL violations, and recommends updating the protocol documentation to reinforce the rule, ensuring "AI works, you rest."

Quick Start

Audit the current session for all task protocol compliance violations and recommend documentation fixes.

Frequently Asked Questions about audit-protocol-compliance

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

FAQPage Schema
How do I audit AI agent conversations for protocol compliance violations?

Audit agent conversations by running this Skill against session transcripts to systematically check for protocol violations like missing user approvals, improper state transitions, and unauthorized direct implementations. It parses the timeline, collects evidence, and generates a JSON report with violations flagged as CRITICAL, HIGH, or LOW severity with remediation guidance.

What protocol rules does the compliance audit check for?

The audit verifies mandatory checkpoints including user approval gates post-synthesis, worktree isolation enforcement, proper agent delegation patterns, correct state transitions, and adherence to task workflow sequences. Each violation is cited with specific timeline evidence (timestamps, tool uses, actors) for objective verification.

Can I use this to prevent future protocol violations in my workflow?

Yes. Beyond flagging current violations, the Skill recommends concrete documentation fixes to your protocol rules based on audit findings. These suggestions help close gaps and reinforce compliance checkpoints so teams can iterate on workflow integrity continuously.

What inputs does the compliance audit require?

Provide session conversation transcripts and your protocol documentation as inputs. The Skill depends on jq for JSON processing and git for potential version tracking. It analyzes structured timeline data to validate agent behavior against your defined compliance rules.

When should I run a compliance audit on agent task sessions?

Run audits after agents complete tasks for post-task review, during investigations of suspected protocol deviations, or before merging work to main branches. The Skill is designed for preventive documentation updates and approval checkpoint verification to maintain workflow integrity.

What does the compliance audit output provide?

The audit produces a detailed JSON report containing identified violations with severity levels, verdict reasoning tied to timeline evidence, specific recommendations for protocol documentation updates, and suggested remediation steps to prevent recurrence.