# Nils CLI Verify Required Checks

> Run the required lint + test commands from DEVELOPMENT.md (fmt, clippy, cargo test, zsh completion). Use when this capability is needed.

- Skill: `tomevault-io/nils-cli-verify-required-checks` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/nils-cli-verify-required-checks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/nils-cli-verify-required-checks/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/nils-cli-verify-required-checks

---


# Nils CLI Verify Required Checks

## Contract

Prereqs:

- Run inside the `nils-cli` git work tree (the script resolves the repo root via `git`).
- `cargo` and a Rust toolchain available on `PATH` (including `rustfmt` and `clippy` components).
- `zsh` available on `PATH`.

Inputs:

- Optional flag: `--docs-only` (documentation-only fast path).

Outputs:

- Runs the required pre-delivery checks from `DEVELOPMENT.md`:
  - `bash scripts/ci/docs-placement-audit.sh --strict`
  - `bash scripts/ci/docs-hygiene-audit.sh --strict`
  - `bash scripts/ci/test-stale-audit.sh --strict`
  - `bash scripts/ci/completion-asset-audit.sh --strict`
  - `cargo fmt --all -- --check`
  - `cargo clippy --all-targets --all-features -- -D warnings`
  - `cargo test --workspace`
  - `bash scripts/ci/completion-flag-parity-audit.sh --strict`
  - `zsh -f tests/zsh/completion.test.zsh`
- In `--docs-only` mode, runs only:
  - `bash scripts/ci/docs-placement-audit.sh --strict`
  - `bash scripts/ci/docs-hygiene-audit.sh --strict`
- Prints the failing command (if any) and exits non-zero on failure.

Exit codes:

- `0`: all checks passed
- `1`: a check failed
- `2`: usage error (invalid arguments) or missing prerequisites

Failure modes:

- Not in a git work tree (cannot resolve repo root).
- Missing required tools on `PATH` (`git`, `cargo`, `zsh`, `rg`).
- Any of the required lint/tests fail.

## Scripts (only entrypoints)

- `.agents/skills/nils-cli-verify-required-checks/scripts/nils-cli-verify-required-checks.sh`

## Workflow

- Run before you claim a task is done.
- For docs-only changes (`README.md` / `docs/**` / `*.md` only), prefer:
  - `.agents/skills/nils-cli-verify-required-checks/scripts/nils-cli-verify-required-checks.sh --docs-only`
- If it fails, fix the reported issue and re-run until it exits `0`.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/graysurf) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->