feat(cli): guide agents to Herdr resources

2 files changed, 5 insertions, 0 deletions

diff --git a/.agents/skills/herdr-pre-release-audit/SKILL.md b/.agents/skills/herdr-pre-release-audit/SKILL.md
index 585bd177..ce5e7d01 100644
--- a/.agents/skills/herdr-pre-release-audit/SKILL.md
+++ b/.agents/skills/herdr-pre-release-audit/SKILL.md
@@ -13,6 +13,7 @@ Read `references/pre-release-audit.md` and follow its workflow. Treat it as the
 - 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`
diff --git a/.agents/skills/herdr-pre-release-audit/references/pre-release-audit.md b/.agents/skills/herdr-pre-release-audit/references/pre-release-audit.md
index c3e14c1b..2dfcb4d4 100644
--- a/.agents/skills/herdr-pre-release-audit/references/pre-release-audit.md
+++ b/.agents/skills/herdr-pre-release-audit/references/pre-release-audit.md
@@ -69,6 +69,7 @@ Process:
    - Compare English next-release website docs against `docs/next/website/src/content/docs/ja/` and `docs/next/website/src/content/docs/zh-cn/`. Flag missing localized files, stale localized files, and heading-outline drift where translated docs do not have the same section structure as English.
    - Compare `docs/next/README.md` and the next website draft against current stable docs. Flag each difference as intended to ship, stale, or needing user decision. Do not require the draft and stable trees to match before release.
    - Also audit example config snippets for release readiness.
+   - Audit `skills/herdr/SKILL.md` against shipped changes to the CLI, public IDs, pane and agent workflows, lifecycle semantics, and safety guidance. Flag stale commands, options, examples, or behavioral claims. The binary bundles this exact file, so review semantic freshness rather than file synchronization.
 
 8. Verify finalization state.
    - Before `just release`, approved README changes must be finalized in `docs/next/README.md`; release CI promotes that tagged file after publication. Do not copy draft website docs into `website/src/content/docs/` or `docs/preview/`.
@@ -116,6 +117,9 @@ Accepted/no action:
 Root docs finalized: YES | NO
 <result of just release-docs-check or why it was not run>
 
+Agent skill: UP TO DATE | NEEDS UPDATE | NOT CHECKED
+<whether skills/herdr/SKILL.md matches the shipped CLI and agent-control behavior>
+
 Nix Cargo lock integration: OK | NEEDS ATTENTION | NOT CHECKED
 <result of nix flake check or any required cargoLock.outputHashes status>