Skip to main content
affpapa.org
RU EN
skill CX Codex

audit-skilly-workflow — Claude Code skill: audit instruction conflicts

Compares repo rules, global instructions, hooks, linters and CI against what skilly installed, then writes an HTML report. It edits nothing.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add timschoch/skilly --skill audit-skilly-workflow -a claude-code
Open on GitHub

What audit-skilly-workflow does

The harness loads every instruction file at once, and on a clash the agent may follow either side. This skill hunts down those clashes between skilly files and everything else.

It runs node .agents/skills/audit-skilly-workflow/scripts/audit.mjs. The script gathers sources with their owner and load mode, installed skills, the repo tier from .skilly/config.json, gate values and config defects. Every source is then read in full, instructions become claims of the form situation → required action with file:line, and skilly claims are matched against the rest by situation rather than by shared wording. Each pair gets a kind: contradiction, restatement, override, precedence stated or complement. When non-skilly sources add up to more than 150 KB, they are split into batches and handed to subagents.

Synced skilly files get overwritten on every sync, so edits there do not survive. For an owner: skilly file the skill suggests moving a deliberate deviation into .claude/rules/<rule>.local.md, and filing a bug against skilly in timschoch/skilly. Output is one self-contained HTML file at the path from report.file, with its directory created if needed. If a hook or sandbox blocks the write, the skill reports the path and stops instead of writing elsewhere.

What it helps with

  • spot repo rules that fight with what skilly installed
  • catch the same rule restated in two files before they drift apart
  • check text limits against the numbers in a gate config
  • work out which side owns the fix
  • see whether a hook or CI job replaces the verify stage

Example prompts for the agent

  • Run the skilly audit and show me where the instructions conflict
  • Build the report on clashes between repo rules and skilly
  • Check whether hooks and CI duplicate what verify already does

How to install audit-skilly-workflow

1Skills CLI (Vercel)

npx skills add timschoch/skilly --skill audit-skilly-workflow -a claude-code

2Manually: put the files in place

~/.claude/skills/audit-skilly-workflow/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/audit-skilly-workflow/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about audit-skilly-workflow

How do I install audit-skilly-workflow in Claude Code?

Run npx skills add timschoch/skilly --skill audit-skilly-workflow -a claude-code. The skill lands at ~/.claude/skills/audit-skilly-workflow/SKILL.md.

What does audit-skilly-workflow do?

It matches claims from skilly files against repo rules, global instructions, hooks, linters and CI. You get an HTML report of the conflicts plus who should fix each one.

Does it change anything in my project?

No. It only reads files and writes a single HTML report at the path from report.file. Fixes happen afterwards, and only for the items you pick.

Similar skills

All skills for Agent setup: memory, context, orchestration →
dependencies-audit cognitedata This skill finds vulnerabilities, outdated and deprecated packages, license problems and supply-chain risks, then fixes them instead of only reporting. CX Codex +1 1,900installs cli-policy-audit cheaper-inference Reads audit logs, access policies and telemetry from the Anthropic CLI. Useful when you need to filter events by type, user or time range. CX Codex +1 952installs isms-audit-expert Alireza Rezvani Skill for ISO 27001 compliance verification, security control assessment, and certification support. Documents audit findings, classifies nonconformities, and manages corrective actions. 791installs security-audit Netresearch DTT GmbH A skill that walks an agent through security reviews of code, infrastructure and AI agent configs using OWASP, CWE and CVSS. Useful before a release or when reading an unfamiliar codebase. CX Codex +1 698installs production-audit affaan-m Checks whether an app is ready to ship and what will break in production. Runs on local evidence, so repo data stays on your machine. CX Codex +1 4,700installs config-audit hoangsonww Walks your ~/.claude setup and reports what has piled up: skills, subagents, hooks, duplicates and risky shell commands. CX Codex +1 ★ 1,121repo stars

From the same set5

git-shortcuts This skill reads a short ---prefixed token such as --cp or --cppr and runs the matching git and GitHub steps. Handy when typing commit, push and PR separately gets old. CX Codex +1 656installs skilly-cli A skill that tells the agent to manage this repo's skills through the skilly CLI: add or remove bundles and skills, pull hub updates. CX Codex +1 647installs naming A skill that lays down naming rules for variables, functions, files, tables and routes. Useful when the agent invents a word your repo does not use. CX Codex +1 546installs vercel-cli This skill lets an agent use Vercel CLI to inspect deployments, environment variables, and runtime logs. Use it when deployment state matters. CX Codex +1 479installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor