Skill

MRU attention protocol for skills that learn from every use — zero compute

Install

npx -y skills add Anoxxx/skillcache --skill skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Activate adaptive heuristics for your installed skills. Use when you want skills to learn and improve from use, when you want to add a HEURISTICS.md layer to existing skills, or when asked to "make my skills adaptive" or "enable skill learning". Also use when reviewing or maintaining existing heuristics across skills.

SKILL.md

3.6 KB, as published. Nobody here has run it

SkillCache Activator

Transform static skills into adaptive ones by adding an MRU (Most Recently Used) heuristics layer that learns from every use.

What This Does

Scans your installed skills (looks for SKILL.md files)
Creates a HEURISTICS.md companion file next to each skill
Injects a small heuristics-aware paragraph into each SKILL.md

After activation, every skill will:

Load its heuristics at activation time
Evaluate what it learned after each use
Maintain a self-prioritizing list of lessons (MRU ordering)

Activation Workflow

Step 1: Discover skills

Find all skill directories the user has installed:

python3 scripts/inject.py --scan --skills-dir <path-to-skills>

This outputs a list of skills found and their current state (already adaptive, or needs activation).

Step 2: Activate

python3 scripts/inject.py --activate --skills-dir <path-to-skills>

For each skill that doesn't already have adaptive heuristics:

Creates HEURISTICS.md with the protocol header
Appends the injection paragraph to SKILL.md (idempotent — won't duplicate if already present)

Step 3: Verify

python3 scripts/inject.py --verify --skills-dir <path-to-skills>

Checks that all activated skills have valid HEURISTICS.md files and injection paragraphs.

Manual Activation (single skill)

If you prefer to activate one skill at a time:

Create HEURISTICS.md next to the skill's SKILL.md:

# Heuristics

<!-- adaptive-skills-protocol: v0.1 | cap: 20 -->

Append to the skill's SKILL.md:

<!-- adaptive-skills v0.1 -->
## Adaptive Heuristics

This skill maintains a `HEURISTICS.md` alongside this file.
Load it at skill activation. After completing the task:

1. **Did anything unexpected happen?** (failure, workaround,
   surprise, user correction) → Append a one-line lesson to
   the TOP of HEURISTICS.md.
2. **Did you rely on an existing heuristic?** → Move it to
   the TOP (MRU promotion).
3. **Does a heuristic contradict this SKILL.md?** → SKILL.md
   wins. Note the conflict in the heuristic entry.

Keep heuristics ≤ 20 entries. When full, the bottom entry
is the eviction candidate.
<!-- /adaptive-skills -->

Maintenance Commands

Review heuristics across all skills

Ask: "Show me the heuristics for all my adaptive skills"

The agent will scan all HEURISTICS.md files and present a summary: which skills have active heuristics, how many entries each, and which entries are near eviction.

Promote a heuristic

Ask: "Promote the top heuristic in [skill-name] to its SKILL.md"

The agent will:

Read the top heuristic entry
Propose where it should be inserted in SKILL.md
Ask for confirmation
Move the entry, bump the skill version, remove from HEURISTICS.md

Reset heuristics

Ask: "Reset heuristics for [skill-name]"

Clears HEURISTICS.md back to the empty template. Useful when switching environments or users.

Privacy Note

HEURISTICS.md may accumulate user-specific preferences (writing style, tool configurations, workflow habits). Before sharing or publishing a skill, review its HEURISTICS.md and remove or redact any personal information.

Protocol Reference

See spec/PROTOCOL.md for the full open standard.