paniolo-scan
Audit
Measures how well a repository is set up for coding agents — and nothing else. The
skill runs the deterministic npx @paniolo/cli scan diagnostic —
a static, read-only pass that never writes a file — presents your scores across the
six harness dimensions with findings grouped by severity, and leads with the
lowest-scoring dimension, where remediation pays off most.
The report is the deliverable. The skill offers paniolo-scan-remediate
as the next step rather than fixing anything itself. The CLI has no
model-judged checks, so the scores stay deterministic.
npx skills add paniolo-ai/skills --skill paniolo-scan
paniolo-scan-remediate
Remediate
Fixes what the audit found. It takes a paniolo scan report —
reusing one from this session or producing a fresh read-only pass — groups the
findings into a severity-banded fix plan, and asks which band to apply
(High + Medium is the default).
Then your agent does the repair in your working tree, preferring shared guidance
over per-adapter duplication, and re-runs the same scan so you can see the grade
move — a before/after delta per dimension, not vibes.
npx skills add paniolo-ai/skills --skill paniolo-scan-remediate
paniolo-config-init
Scaffold config
Writes a starter paniolo.config.json — the file that tells the scanner
which AI harnesses your repository is tuned for. It inspects the adapters already
present (CLAUDE.md, .cursor/, Copilot instructions,
AGENTS.md, GEMINI.md, .agents/), asks which of
the seven supported harnesses you want, and writes a deliberately minimal config.
The file grows with the rule set, so the skill never pre-populates it — and if a
config already exists, it shows you what's there before touching anything. The
scanner only ever reads this file; this skill is the only thing that writes it.
npx skills add paniolo-ai/skills --skill paniolo-config-init
paniolo-config-upgrade
Upgrade config
Moves an existing paniolo.config.json forward — normalizing every
repo onto the repos map and factoring the policy a dozen siblings
repeat into shared repoDefaults and named repoTypes
layers (node → type → defaults → preset, host untouched).
It prefers the CLI's own writers —
paniolo evolve config migrate previews then applies a verified,
comment-preserving rewrite; evolve config effective answers
"where did this value come from" — and registers repos and wikis through
evolve harness connect and paniolo wiki init.
npx skills add paniolo-ai/skills --skill paniolo-config-upgrade