From 3dae2b1945df2f967641adf593847ab554ee1a5b Mon Sep 17 00:00:00 2001
From: Matt Pocock <mattpocockvoice@gmail.com>
Date: Thu, 30 Apr 2026 10:12:35 +0100
Subject: [PATCH] Add verify/check mode documentation and list-skills script

---
 .out-of-scope/setup-skill-verify-mode.md | 15 +++++++++++++++
 scripts/list-skills.sh                   |  7 +++++++
 2 files changed, 22 insertions(+)
 create mode 100644 .out-of-scope/setup-skill-verify-mode.md
 create mode 100755 scripts/list-skills.sh

diff --git a/.out-of-scope/setup-skill-verify-mode.md b/.out-of-scope/setup-skill-verify-mode.md
new file mode 100644
index 0000000..70d8714
--- /dev/null
+++ b/.out-of-scope/setup-skill-verify-mode.md
@@ -0,0 +1,15 @@
+# Verify/Check Mode for `setup-matt-pocock-skills`
+
+This project will not add a dedicated verify/check mode (or a separate verify skill) for `setup-matt-pocock-skills`.
+
+## Why this is out of scope
+
+A second skill — or a `--verify` flag — for checking whether `docs/agents/*.md` artifacts still match the seed-template schema would duplicate work the existing setup skill already handles in conversation.
+
+The intended workflow is: **run `/setup-matt-pocock-skills` and tell it to verify your current setup.** The skill is prompt-driven, so the maintainer can scope it to a verification pass ("don't rewrite anything, just check my existing files against the current seed templates and report drift") without needing a separate code path. Adding a flag or a sibling skill would split the surface area of a feature that's already expressible through the natural-language entry point.
+
+Keeping configuration management to a single skill also avoids the maintenance cost of two skills drifting from each other when seed templates evolve.
+
+## Prior requests
+
+- #106 — Feature request: verify/check mode for setup-matt-pocock-skills
diff --git a/scripts/list-skills.sh b/scripts/list-skills.sh
new file mode 100755
index 0000000..f13da41
--- /dev/null
+++ b/scripts/list-skills.sh
@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO="$(cd "$(dirname "$0")/.." && pwd)"
+
+cd "$REPO"
+find . -name SKILL.md -not -path '*/node_modules/*' | sed 's|^\./||' | sort