docs(skill): add audit-clerk-skill for drift detection#156
Draft
wyattjoh wants to merge 1 commit intofeat/clerk-cli-skill-pinnedfrom
Draft
docs(skill): add audit-clerk-skill for drift detection#156wyattjoh wants to merge 1 commit intofeat/clerk-cli-skill-pinnedfrom
wyattjoh wants to merge 1 commit intofeat/clerk-cli-skill-pinnedfrom
Conversation
This was referenced Apr 14, 2026
Contributor
Author
|
Stack: init-skills Part of a stacked PR chain. Do not merge manually. |
4 tasks
fd4e18e to
0ac582c
Compare
0ac582c to
93a54b9
Compare
97cadfd to
9255b9a
Compare
93a54b9 to
140f8d1
Compare
998207f to
71e2f9f
Compare
140f8d1 to
51a17d9
Compare
|
51a17d9 to
b6a5d82
Compare
71e2f9f to
8078ef6
Compare
b6a5d82 to
6745d77
Compare
8078ef6 to
7a2025d
Compare
6745d77 to
ac7474c
Compare
7a2025d to
61ddd30
Compare
ac7474c to
84a4ce1
Compare
Adds a user-invocable skill that cross-checks skills/clerk/ against the CLI source tree (packages/cli-core/src/commands/**) and proposes targeted edits when the two drift. Reads per-command README.md files as a secondary source, prefers --help over enumerating flags, and routes proposals between SKILL.md and references/*.md based on content type. Configured with effort: high and disable-model-invocation: true so it is a manual maintenance task, with an optional --apply argument to write changes rather than just proposing them.
84a4ce1 to
6f1b78f
Compare
9c7d911 to
61a2b63
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
New user-invocable skill that cross-checks
skills/clerk/againstpackages/cli-core/src/commands/**and proposes targeted edits when the two drift.Reads per-command
README.mdfiles as a secondary source (to flag mocked or hidden surfaces), prefers--helpover enumerating flags, and routes proposals betweenSKILL.md,references/agent-mode.md,references/auth.md, andreferences/recipes.mdbased on content type.Configured with
effort: high,disable-model-invocation: true(manual maintenance task), and an optional--applyargument to write changes rather than just proposing them.Stacked on #126.
Test plan
/audit-clerk-skilland confirm it produces the documented output shape (bucketed proposals, source citations, severity tags)--applyon a synthetic drift case and confirm it writes onlydriftandgapedits, leavingpolishsuggestions for review