rules

A rule set is a watches/watch-*.yml file; each holds block and ask rules that the PreToolUse hook matches against commands. This skill lists them and walks any change through preview and tests before writing.

Steps

1. Find the plugin root

All paths below are relative to ${CLAUDE_PLUGIN_ROOT}, which Claude Code sets when the skill runs. If it is empty, stop and report — do not guess a path, since running against the wrong directory would edit the wrong rule files.

2. Discover rule sets

List YAML files in ${CLAUDE_PLUGIN_ROOT}/watches/. Each file is a rule set (e.g. watch-git.yml, watch-installs.yml).

Also check for disabled rule sets — files ending in .yml.disabled in the same directory. These are rule sets that have been toggled off.

3. Read and display rules for each rule set

For each enabled rule set, present rules in two tables. Use the rule set name field as the heading. Use the naming convention <ruleset>-block-NN / <ruleset>-ask-NN for IDs, where <ruleset> is the short name from the YAML name field (e.g. watch-git → git), and NN is zero-padded (e.g. git-block-01, installs-ask-03):

watch-git (watches/watch-git.yml)

🚫 block — rejected outright:

id	command	reason
git-block-01	name	reason

❓ ask — require confirmation:

id	command	reason
git-ask-01	name	reason

After listing all enabled rule sets, if any disabled rule sets exist, list them:

Disabled rule sets:

• watch-foo (watches/watch-foo.yml.disabled)

4. Check for --list flag

If the user passed --list, stop here and do not enter the edit loop.

5. Prompt for edits

Ask: "Make any changes? (Enter a command or press Enter to skip)"

Commands:
  <id>:block      — move rule to block       (e.g. git-ask-02:block)
  <id>:ask        — move rule to ask          (e.g. git-block-03:ask)
  <id>:allow      — remove rule entirely      (e.g. installs-ask-05:allow)
  add             — add a new rule
  disable <name>  — disable an entire rule set (e.g. disable watch-files)
  enable <name>   — re-enable a disabled rule set (e.g. enable watch-files)
  new             — create a new custom rule set
  done / ↵        — finish
>