Files
holocron/plugins/git/.apm/skills/pc-run
Defame1297 14af50bc07 fix(git): scope git-workflow's trigger to ambiguity rather than to its domains
git-workflow's description enumerated the six domains it exists to route away
from, so it competed for selection with the very skills it should be handing
off to. It now triggers on the case it actually serves: an interactive request
whose domain is not yet clear.

Also clears frontmatter drift across the plugin and removes duplicated guidance
in pc-run that had diverged from its reference.
2026-08-31 08:01:39 +00:00
..

pc-run

Runs, installs, updates, and maintains pre-commit hooks in a local git clone.

What it does

pc-run handles everything that happens after .pre-commit-config.yaml exists: wiring hooks into git, running them, bumping their versions, and maintaining the cache. When hooks fail, it identifies the cause and suggests a concrete fix — it does not auto-fix files or edit the config. For creating or editing .pre-commit-config.yaml, use pc-author instead.

Before you start

  • pre-commit must be installed and available on PATH
  • A .pre-commit-config.yaml must exist at the repo root (use pc-author to create one)

Usage

Common invocations:

  • /pc-run — run all hooks against all files (default)
  • /pc-run install — wire hooks into .git/hooks/
  • /pc-run autoupdate — bump all rev values to latest
  • /pc-run clean — wipe the pre-commit cache (requires confirmation)

Files

File Purpose
SKILL.md Skill instructions for agents
references/install.md The install flow — loaded when the user asks to install or set up hooks
references/autoupdate.md The autoupdate flow — loaded when the user asks to bump hook revs
references/clean.md The clean flow — loaded when the user asks to wipe the cache or rebuild environments
references/failure-patterns.md Hook failure causes and concrete fix suggestions — loaded when a hook fails or never fires
references/sources.md Provenance: research sources that informed this skill
references/README.md Directory index for references/