cp-skill-validate
Run deterministic validation on KB artifacts, collections, collection landings, and the published redirect map, including schemas, links, required sections, and batch signals.
Install
npx skills add https://github.com/zby/commonplace/tree/main/kb/instructions/cp-skill-validate
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install zby-commonplace@llmmart
git clone https://github.com/zby/commonplace.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole zby/commonplace collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
EXECUTE NOW
Run the packaged validation command. For all, invoke each top-level collection separately because the CLI deliberately rejects a repository-wide literal scope:
if [ "$ARGUMENTS" = "all" ]; then
for contract in kb/*/COLLECTION.md; do
commonplace-validate "$(basename "$(dirname "$contract")")" || exit $?
done
commonplace-validate landings || exit $?
if [ -f properdocs.yml ]; then
commonplace-validate redirects || exit $?
fi
else
commonplace-validate "$ARGUMENTS"
fi
Target: $ARGUMENTS
Prefer the narrowest target that covers the user's request. For write/edit workflows, validate the new or edited file paths explicitly; do not validate the whole KB unless the user asked for a full maintenance check.
- Note path or name: validate that specific note
- Multiple note paths: validate those specific notes, one command per path if needed
- Directory path or collection name: validate
.mdfiles under that directory, only when the edited set is directory-scoped - "all": validate each top-level collection in a separate command
- "landings": validate that every top-level collection has a non-colliding
README.md - "redirects": validate the live
properdocs.ymlredirect map against its published tree - "notes": validate all
.mdfiles inkb/notes/ - "recent" or "today": validate notes modified today
- Empty: ask which note to validate
Report the script output directly. Do not interpret, supplement, or override its findings.
For judgment-based frontmatter checks, run kb/instructions/run-review-batches.md with the frontmatter bundle.
Files (commonplace)
-
SKILL.md 1.9 KB
--- name: cp-skill-validate description: Run deterministic validation on KB artifacts, collections, collection landings, and the published redirect map, including schemas, links, required sections, and batch signals. type: kb/types/instruction.md user-invocable: true allowed-tools: Bash context: fork --- ## EXECUTE NOW Run the packaged validation command. For `all`, invoke each top-level collection separately because the CLI deliberately rejects a repository-wide literal scope: ```bash if [ "$ARGUMENTS" = "all" ]; then for contract in kb/*/COLLECTION.md; do commonplace-validate "$(basename "$(dirname "$contract")")" || exit $? done commonplace-validate landings || exit $? if [ -f properdocs.yml ]; then commonplace-validate redirects || exit $? fi else commonplace-validate "$ARGUMENTS" fi ``` **Target: $ARGUMENTS** Prefer the narrowest target that covers the user's request. For write/edit workflows, validate the new or edited file paths explicitly; do not validate the whole KB unless the user asked for a full maintenance check. - Note path or name: validate that specific note - Multiple note paths: validate those specific notes, one command per path if needed - Directory path or collection name: validate `.md` files under that directory, only when the edited set is directory-scoped - "all": validate each top-level collection in a separate command - "landings": validate that every top-level collection has a non-colliding `README.md` - "redirects": validate the live `properdocs.yml` redirect map against its published tree - "notes": validate all `.md` files in `kb/notes/` - "recent" or "today": validate notes modified today - Empty: ask which note to validate Report the script output directly. Do not interpret, supplement, or override its findings. For judgment-based frontmatter checks, run `kb/instructions/run-review-batches.md` with the `frontmatter` bundle.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.