Skills

Agent skills, portable by design

Skills are small, versioned playbooks your coding agent loads on demand — the portable layer of Paniolo's harness tooling. One install puts them into every skill-capable agent on your machine: Claude Code, Cursor, Copilot, Codex, Devin, Gemini CLI, and 70+ more.

Install every Paniolo skill, for every agent
npx skills add paniolo-ai/scan --all

paniolo-scan

Audit + remediate

Measures how well a repository is set up for coding agents, then fixes what it finds. 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.

Then your agent does the repair: pick findings (High + Medium is the default), the agent applies them in your working tree, and the scan re-runs so you can see the grade move. An opt-in AI review can add model judgment on top of the deterministic checks — fenced off, so it never touches the scores.

Reach for it when

"Scan my harness" · "Audit my CLAUDE.md setup" · "Check my AI agent configuration" · /paniolo-scan

Also available as

A native /paniolo-scan slash command in the Claude Code plugin and an Antigravity workflow.

npx skills add paniolo-ai/scan --skill paniolo-scan

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 six 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.

Reach for it when

"Init paniolo config" · "Set up paniolo.config.json" · "Which AI vendors should this repo support" · /paniolo-config-init

Also available as

A native /paniolo-config-init slash command in the Claude Code plugin.

npx skills add paniolo-ai/scan --skill paniolo-config-init
The library

Every best-practice skill

The conventions Paniolo agents run on, published as installable skills — each one a tight, loadable playbook for a recurring kind of work. Install all of them, or just the ones your agent needs.

npx skills add paniolo-ai/skills --all

Harness & knowledge workflow

paniolo-qmd

Find the right skill, doc, or repo guidance with workspace semantic search before task-shaped work begins.

paniolo-wiki

Maintain a structured LLM wiki — ingest sources, author pages, lint, and reorganize.

paniolo-plan-best-practices

Author executable implementation plans — dependency-ordered cards, observable acceptance criteria, verification gates.

paniolo-plan-execution

Execute or audit an existing plan — revalidate claims against current code, diagnose failures before patching, report honestly.

paniolo-doc-best-practices

Documentation standards — naming, structure, formatting, and when a topic needs a doc, a skill, or both.

TypeScript, React & code structure

paniolo-react-compiler

React Compiler constraints — no manual memoization, no render side effects, diagnosing compiler errors.

paniolo-file-splitting

Break large consolidated files into single-function modules — naming, exports, test colocation.

Testing

Deploy & operations

The product skills ship from paniolo-ai/scan; the best-practice library from paniolo-ai/skills — both MIT licensed and listed on skills.sh. The CLI they drive is @paniolo/cli; install it directly with npx @paniolo/cli scan . for a read-only scan, no account required.