cp-skill-validate

SkillDev tools

Run deterministic validation on KB artifacts, collections, collection landings, and the published redirect map, including schemas, links, required sections, and batch signals.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the cp-skill-validate skill

What this skill tells your AI

The instructions your AI receives, as published by zby/commonplace in kb/instructions/cp-skill-validate/SKILL.md and read by ahel’s review.

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 .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.

Signals

GitHub stars
88
Forks
11
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
cp-skill-validate
Source
github.com/zby/commonplace