33 lines
1.5 KiB
Markdown
33 lines
1.5 KiB
Markdown
---
|
|
paths: ["skills/graphify/**", "install-plugins.sh"]
|
|
---
|
|
|
|
# Machine-owned: the vendored graphify skill
|
|
|
|
`skills/graphify/SKILL.md`, `skills/graphify/references/` and
|
|
`.graphify_version` are written by `graphify claude install`
|
|
(`install-plugins.sh` STEP graphify), which lands in the repo because
|
|
`~/.claude/skills` is a symlink to `skills/`. They are gitignored: a
|
|
`pipx upgrade graphifyy` used to dirty the tree and cost a
|
|
`chore(graphify): sync vendored skill X -> Y` commit each time.
|
|
|
|
Two graphify commands, easy to confuse, and only one restores the skill:
|
|
- `graphify install --platform claude` copies SKILL.md + `references/` +
|
|
`.graphify_version` into `skills/graphify/`. Touches nothing else.
|
|
This is the recovery command.
|
|
- `graphify claude install` writes the CLAUDE.md graphify section and the
|
|
`.claude/settings.json` PreToolUse hooks. It **rewrites both guarded
|
|
configs** (EVAL-020, verified again 2026-09-15), so revert them after. It does NOT copy
|
|
the skill.
|
|
|
|
`make plugin` runs both (`install-plugins.sh` STEP graphify) behind the
|
|
guarded-config EXIT trap, so a fresh clone is covered.
|
|
|
|
Trade-off accepted: an upstream release can now change the skill's prompt
|
|
with no diff to review. `skills/graphify/test-prompts.json` is hand-written
|
|
for darwin and stays tracked.
|
|
|
|
Gotcha, learned the hard way: `git rm --cached` keeps the working file,
|
|
but if the branch you merge into still tracks it, the merge deletes it
|
|
from disk. Untrack and merge, then restore with the command above.
|