plugins/lintguini/skills/audit/SKILL.md
Audit lint-posture (linter strictness, formatter presence, CI enforcement, rule-suppression count) in a target codebase
npx skillsauth add acostanzo/quickstop auditInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Audit the target codebase for Lint / format / language rules and emit a v2 wire-contract envelope.
Run the orchestrator and emit its stdout verbatim:
bash "${CLAUDE_PLUGIN_ROOT}/bin/build-envelope.sh" "<REPO_ROOT>"
<REPO_ROOT> is the absolute path to the target repository — typically the working directory when /lintguini:audit was invoked.
The orchestrator runs four deterministic shell scorers, one per rubric category in the lint-posture dimension:
score-linter-presence.sh — counts configured linter rules against the per-language baselinescore-formatter-presence.sh — checks for a configured formatterscore-ci-lint-wired.sh — greps CI surfaces for lint invocationsscore-suppression-count.sh — counts suppression markers across source filesEach scorer's output (one observation entry, or empty for empty-scope) is jq -s'd into the envelope's observations[] array. Composite_score is computed by a transitional formula until the rubric stanza lands in 2b3.
The orchestrator is pure shell + grep + awk + jq — no language toolchain on PATH is required, no network calls, no consumer-state mutation. ADR-006 §2 (no silent mutation of consumer artefacts) and §3 (vacuously satisfied: lintguini ships no hooks) hold at scorer level.
Emit the orchestrator's stdout verbatim. Do not modify the JSON, do not add commentary — the orchestrator is the source of truth for the wire envelope.
documentation
Surface (and optionally fix) doc-tree drift — duplicates, dead links, stale docs, template non-compliance, missing `## Related` blocks. Read-only by default; `--apply` does mechanical fixes; `--apply-semantic` emits diffs for human review.
documentation
Full-text search over the repo's `docs/` tree (FTS5-backed). Returns ranked hits with file paths, tags, and matching snippets.
testing
Retrieval-augmented Q&A over the repo's `docs/` tree. Returns a one-paragraph synthesis plus citations (doc path + heading anchor) and per-citation corroboration verdicts. Field shape and ordering are locked at M3; M5 populates the verdicts.
documentation
Scaffold a new doc under `docs/` from a Diátaxis template, or update an existing one and bump its `updated:` date. Suggests `## Related` candidates and refreshes the FTS5 index on write.