Agent skill · AI & Agents

skill-comply

Visualize whether skills, rules, and agent definitions are actually followed — auto-generates scenarios at 3 prompt strictness levels, runs agents, classifies behavioral sequences, and reports compliance rates with full tool call timelines

mturacgithub.com/mturacGitHub ↗
codexcopilotcursorships scriptsMIT
Install
npx skills add mturac/everything-openai-codex --skill skill-comply --agent codex

Same command for any agent — swap --agent for claude-code, cursor, copilot.

Facts
Files in the skill folder: 22
SKILL.md size: 2 KB
Bundled scripts: yes
Path: skills/skill-comply/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 84
Language: JavaScript

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# skill-comply: Automated Compliance Measurement Measures whether coding agents actually follow skills, rules, or agent definitions by: 1. Auto-generating expected behavioral sequences (specs) from any .md file 2. Auto-generating scenarios with decreasing prompt strictness (supportive → neutral → competing) 3. Running `codex -p` and capturing tool call traces via stream-json 4. Classifying tool calls against spec steps using LLM (not regex) 5. Checking temporal ordering deterministically 6. Generating self-contained reports with spec, prompts, and timelines ## Supported Targets - **Skills** (`skills/*/SKILL.md`): Workflow skills like search-first, TDD guides - **Rules** (`rules/common/*.md`): Mandatory rules like testing.md, security.md, git-workflow.md - **Agent definitions** (`agents/*.md`): Whether an agent gets invoked when expected (internal workflow verification not yet supported) ## When to Activate - User runs `/skill-comply <path>` - User asks "is this rule actually being followed?" - After adding new rules/skills, to verify agent compliance - Periodically as part of quality maintenance ## Usage ```bash # Full run uv run python -m scripts.run ~/.codex/rules/common/testing.

What's inside
Steps it walks through
  1. Supported Targets
  2. When to Activate
  3. Usage
  4. Key Concept: Prompt Independence
  5. Report Contents
  6. Advanced (optional)
Ships with 21 files
  • .gitignore
  • fixtures/compliant_trace.jsonl
  • fixtures/noncompliant_trace.jsonl
  • fixtures/tdd_spec.yaml
  • prompts/classifier.md
  • prompts/scenario_generator.md
  • prompts/spec_generator.md
  • pyproject.toml
  • scripts/__init__.py
  • scripts/classifier.py
  • scripts/grader.py
  • scripts/parser.py
  • scripts/report.py
  • scripts/run.py
  • scripts/runner.py
  • scripts/scenario_generator.py
  • scripts/spec_generator.py
  • scripts/utils.py
  • tests/test_grader.py
  • tests/test_parser.py
  • tests/test_runner.py
Commands it runs
Full run
uv run python -m scripts.run ~/.codex/rules/common/testing.md
Dry run (no cost, spec + scenarios only)
uv run python -m scripts.run --dry-run ~/.codex/skills/search-first/SKILL.md
Custom models
uv run python -m scripts.run --gen-model fast --model standard <path>
More from everything-openai-codex
All skills →
About this skill
What does the skill-comply skill do?

Visualize whether skills, rules, and agent definitions are actually followed — auto-generates scenarios at 3 prompt strictness levels, runs agents, classifies behavioral sequences, and reports compliance rates with full tool call timelines

How do I install it?

Run `npx skills add mturac/everything-openai-codex --skill skill-comply --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From mturac/everything-openai-codex, a repository with 84 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going