Sync the Logic-Lens working-copy skills/ into the installed plugin cache so content-evals test the EDITED skill, not the last published one. ALWAYS run this after editing any skills/**/SKILL.md or guide/_shared file and BEFORE running content-evals — otherwise the eval silently grades stale content and every token is wasted. Also use to verify the cache is in sync ("is the cache fresh?", "did my edit take effect in evals?", "check skill cache drift").
Installs into .claude/skills of the current project.
Are you the author of Sync Skill Cache?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/hyhmrright-sync-skill-cache)
---
name: sync-skill-cache
description: Sync the Logic-Lens working-copy skills/ into the installed plugin cache so content-evals test the EDITED skill, not the last published one. ALWAYS run this after editing any skills/**/SKILL.md or guide/_shared file and BEFORE running content-evals — otherwise the eval silently grades stale content and every token is wasted. Also use to verify the cache is in sync ("is the cache fresh?", "did my edit take effect in evals?", "check skill cache drift").
disable-model-invocation: true
---
# sync-skill-cache
content-evals invoke each skill through Claude Code's plugin mechanism, which loads from
`~/.claude/plugins/cache/logic-lens-marketplace/logic-lens/<version>/skills/` — **not** the
repo's `skills/`. Editing `skills/` changes nothing the eval sees until you copy it into the
cache. This is the single most expensive footgun in the iteration loop: skip it and you grade
the previous skill while believing you tested your change.
## Steps
1. **Sync + verify** from the repo root:
```bash
bash .claude/skills/sync-skill-cache/scripts/sync-cache.sh
```
The script reads the active version from `package.json`, rsyncs `skills/` into the matching
cache dir (`--delete`, so removed files are removed in the cache too), then diffs the two to
confirm they are byte-identical. It prints `OK …` on success.
2. **If it prints `DRIFT` or a missing-cache error:** do not run evals. The two common causes:
- The cache dir for the current `package.json` version doesn't exist (plugin not installed at
this version) — reinstall/refresh the plugin, or check you didn't just bump the version
without refreshing the cache.
- rsync was blocked — rerun and read the diff list it prints.
3. **Verify-only mode** (no copy) to answer "is the cache fresh?":
```bash
bash .claude/skills/sync-skill-cache/scripts/sync-cache.sh --check
```
This skill is the mandatory gate between editing a skill and grading it. The `iterate-skill`
orchestrator calls it automatically; run it by hand whenever you edit a skill outside that loop.
