Skip to content

ivuorinen/skills

Repository files navigation

ivuorinen-skills

Hostile audit skills for Claude Code.

Skills

Skills are listed in preferred execution order. nitpicker is the orchestrator — start there for a full audit.

Skill Description
nitpicker Exhaustive repository audit; finds defects across code, tests, docs, and config; optionally applies fixes
arch-detector Detects which architectural patterns a codebase uses (19 patterns, 8 canonical combinations)
arch-auditor Audits codebase for architectural violations against detected or declared patterns
doc-auditor Verifies all documentation accuracy against the codebase; finds stale, incorrect, and missing docs
security-auditor Audits a codebase with available security scanners, parses results, and writes a consolidated findings report
adversarial-reviewer Hostile code review; assumes bugs exist and hunts for them
pr-reviewer Hostile but constructive PR review; outputs copy-paste-ready markdown for GitHub PR comments
cr-implementer Fetches GitHub PR review comments (unresolved where available via GraphQL), evaluates and implements valid ones one at a time, verifies with tests and linting, and asks user whether to leave/commit/push
claude-rules-auditor Audits .claude/rules/ files for quality, checks CLAUDE.md for misplaced rules, and suggests new rules from project conventions and audit artifacts
loophole-hunter Audits the Claude Code enforcement surface (.claude/rules/, hooks, .claude/settings.json, permissions, skills) for bypassable or unenforced constraints and closes them; invoked by nitpicker in loophole mode and by release-prep as a gate
hooks-enforcer Audits an agent project's hook coverage against its evidence base (current hooks, audit-findings history, git history, project memory); finds recurring failures no hook guards and context-discipline gaps where large-output work bypasses a context-saving tool; specifies and wires the missing hooks in the host harness's correct shape; invoked by nitpicker in loophole mode and by release-prep as a gate

Installation

Add the marketplace

/plugins marketplace add ivuorinen/skills

Install the plugin

/plugins install ivuorinen-skills

Usage

Invoke any skill by name in Claude Code (listed in execution order):

  • /nitpicker — exhaustive audit + optional auto-fix
  • /arch-detector — detect architecture patterns
  • /arch-auditor — audit architecture violations
  • /doc-auditor — verify documentation accuracy
  • /security-auditor — security audit with available local scanners
  • /adversarial-reviewer — hostile code review
  • /pr-reviewer — PR review (stdout only)
  • /cr-implementer — implement PR review comments
  • /claude-rules-auditor — audit .claude/rules/ and CLAUDE.md rule placement
  • /loophole-hunter — audit the Claude Code enforcement surface and close loopholes
  • /hooks-enforcer — audit hook coverage against the project's evidence base and wire the missing hooks

Examples

Full repository audit (recommended starting point)

/nitpicker

Exhaustive audit of code, tests, docs, and config. Findings written to docs/audit/nitpicker-findings.md. At the end, nitpicker offers to apply fixes and asks before committing.

Focused nitpicker modes

/nitpicker security          # invokes security-auditor, then extends with trust-boundary analysis
/nitpicker docs              # invokes doc-auditor, then extends with inline comment accuracy
/nitpicker architecture      # invokes arch-detector + arch-auditor, then extends with coupling analysis
/nitpicker changed-files     # limit review to modified files and their dependencies only
/nitpicker release-gate      # fail if any High or Critical findings exist (CI gate)
/nitpicker inline            # return findings in the response, no file written

Architecture pipeline

/arch-detector    # detect patterns → writes docs/audit/arch-profile.md
/arch-auditor     # find violations → writes docs/audit/arch-findings.md

Run arch-detector first — arch-auditor reads the profile and produces stronger, more precise findings.

Security scan

/security-auditor

Probes for available scanners (semgrep, grype, trivy, gitleaks, checkov, gosec, snyk, npm/yarn/pnpm audit) and runs all that are present.

PR review

/pr-reviewer          # review the current branch diff
/pr-reviewer 42       # review PR #42 on GitHub

Output is copy-paste-ready markdown for GitHub PR comments.

Implement review comments

/cr-implementer       # detect and implement unresolved comments on the current PR
/cr-implementer 42    # implement comments on PR #42

Evaluates each comment, implements valid ones one at a time, verifies with tests and linting, and asks before committing or posting replies.

Running nitpicker autonomously with /goal

/goal sets a completion condition and keeps Claude working toward it across turns — no re-prompting after each step. After each turn, a separate fast model checks whether the condition holds. If not, Claude starts another turn automatically. The goal clears once the condition is met.

/goal /nitpicker finds no Critical or High findings and docs/audit/nitpicker-findings.md is committed

For fully unattended runs, enable auto mode before setting the goal. Auto mode uses a background classifier to approve tool calls (file edits, shell commands) without prompting you:

Layer What it removes
/goal Per-turn prompts — Claude re-enters after each turn until the condition holds
Auto mode Per-tool prompts — file edits and shell commands proceed without confirmation

Enable auto mode: press Shift+Tab in the CLI until auto is shown, or use the mode selector in VS Code or Desktop.

# 1. Enable auto mode first (Shift+Tab in the CLI)
# 2. Then set the goal:
/goal /nitpicker security applies all Critical and High fixes, docs/audit/nitpicker-findings.md shows 0 open Critical/High

Write effective goal conditions with a verifiable end state — something Claude's own output can demonstrate: a file written, a count reached, a command exit code. Include a turn limit to bound how long the goal can run: or stop after 15 turns.

/goal requires Claude Code v2.1.139 or later. See the /goal documentation and auto mode reference for full details.

Versioning

This plugin follows Semantic Versioning:

  • PATCH — skill improvements, bug fixes, clarifications
  • MINOR — new skills added
  • MAJOR — breaking changes to skill behavior or output format

Releases are automated via release-please. Commit messages must follow Conventional Commits.

See CHANGELOG.md for version history.

License

This project is licensed under the MIT License. Copyright © 2026 Ismo Vuorinen.

About

My assortment of Claude Code skills

Topics

Resources

License

Stars

Watchers

Forks

Contributors