crux-skill-memory-reference-tracker

Track memory reference usage and maintain externalized .refs.yml metadata.

8|1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/zotoio/CRUX-Compress --skill crux-skill-memory-reference-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crux-skill-memory-reference-tracker
Source: https://github.com/zotoio/CRUX-Compress/tree/main/.cursor/skills/crux-skill-memory-reference-tracker
Command: npx skills add https://github.com/zotoio/CRUX-Compress --skill crux-skill-memory-reference-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents memory usage tracking from becoming inconsistent by maintaining reliable reference counts, recency data, and promotion signals outside of memory content.

Core Features & Use Cases

  • Reference Tracking: Records when agent outputs are influenced by memories and maintains per-memory tracker files with usage history.
  • Tracker Management: Creates, updates, cleans up, and synchronizes.refs.yml files while keeping memory metadata focused on content.
  • Use Case: Help an AI coding workflow identify frequently reused memories and determine which ones may be candidates for permanent project rules.

Quick Start

Use the crux memory reference tracker skill to record a new memory reference and update its usage tracking information.

Frequently Asked Questions about crux-skill-memory-reference-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is memory reference tracking in agent workflows?

Memory reference tracking records when agent outputs are influenced by stored memories. It maintains per-memory tracker files with usage history to prevent tracking inconsistencies and keep memory metadata focused strictly on content.

How do I track memory usage to identify promotion candidates for project rules?

To identify promotion candidates, track memory usage by recording reference counts and recency data. This Skill applies configurable thresholds to usage history, helping you determine which frequently reused memories should become permanent project rules.

How do I clean up orphaned .refs.yml files in a memory tracking system?

To clean up orphaned .refs.yml files, use tracker management routines that synchronize tracker fields and remove outdated reference history files. This ensures externalized metadata stays aligned without cluttering the actual memory content.

Can I use YAML tracker files to manage agent memory influence history?

Yes, you can use .refs.yml files to manage agent memory influence history. This Skill creates, updates, and synchronizes these YAML files to maintain reliable reference counts and promotion signals outside of memory content.

Why does my agent memory system have inconsistent reference counts?

Inconsistent reference counts occur when memory usage tracking lacks externalized metadata. By maintaining synchronized tracker fields and structured reference history in separate files, this Skill prevents reference counts and recency data from becoming unreliable.