---
name: Herdr Pre-Release Audit
slug: herdr-pre-release-audit
category: Quality
description: Herdr Pre-Release Audit compares commits since the base release against the next-release changelog, docs, and issue reference lines to confirm release readiness and CI behavior. Use it when finalizing herdr release docs or validating docs/next before a release.
github: "https://github.com/herdrdev/herdr/tree/master/.agents/skills/herdr-pre-release-audit"
language: Rust
stars: 28752
forks: 2045
install: "npx degit https://github.com/herdrdev/herdr/tree/master/.agents/skills/herdr-pre-release-audit ~/.claude/skills/herdr-pre-release-audit"
installs_to: ~/.claude/skills/herdr-pre-release-audit
source_path: .agents/skills/herdr-pre-release-audit/SKILL.md
collection_size: 5
category_size: 1354
collection_url: "https://dirskills.com/collections/herdrdev/herdr"
added: 2026-08-14T07:11:49.198Z
last_synced: 2026-08-14T07:11:49.198Z
canonical_url: "https://dirskills.com/skills/herdr-pre-release-audit"
---

# Herdr Pre-Release Audit

Herdr Pre-Release Audit compares commits since the base release against the next-release changelog, docs, and issue reference lines to confirm release readiness and CI behavior. Use it when finalizing herdr release docs or validating docs/next before a release.

**Install:**

```bash
npx degit https://github.com/herdrdev/herdr/tree/master/.agents/skills/herdr-pre-release-audit ~/.claude/skills/herdr-pre-release-audit
```

## README

# Herdr Pre-release Audit

Use this skill only inside the herdr repository.

Read `references/pre-release-audit.md` and follow its workflow. Treat it as the source of truth for:

- choosing the release base ref
- inspecting first-parent history and merged PRs
- auditing `docs/next/CHANGELOG.md`
- auditing `docs/next/README.md` and staged website docs
- checking `skills/herdr/SKILL.md` against shipped CLI and agent-control behavior
- checking issue reference lines
- deciding when to run `just pre-release-check` or its component checks
- running and assessing `just bench-render-scale`
- producing the final release-readiness report

Do not edit files during the audit unless the user explicitly asks to apply fixes. When applying fixes, keep changes scoped to the files named in the reference workflow.