compound-refresh

Review docs/compound entries against current repository reality and classify them.

1|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/softwaresalt/csv-managed --skill compound-refresh-softwaresalt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compound-refresh
Source: https://github.com/softwaresalt/csv-managed/tree/main/.github/skills/compound-refresh
Command: npx skills add https://github.com/softwaresalt/csv-managed --skill compound-refresh-softwaresalt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents your docs/compound/ knowledge base from drifting out of sync with the codebase by reviewing, classifying, and refreshing entries using evidence instead of guesswork.

Core Features & Use Cases

  • Evidence-gathered maintenance: review in-scope compound entries against current code, architecture, and workflow reality.
  • Deterministic entry classification: classify each reviewed entry as keep, update, consolidate, replace, or delete (or mark as stale when confidence is low).
  • Controlled change application: run in propose mode for recommendations or apply mode to update/consolidate/replace/archive as supported by evidence.
  • Accountable refresh reporting: produce a refresh report in docs/closure/{YYYY-MM-DD}-{slug}-compound-refresh.md summarizing evidence, actions, and follow-ups.

Quick Start

Use the compound-refresh skill with scope recent and mode propose to generate a refresh report for the newest items in docs/compound/.

Frequently Asked Questions about compound-refresh

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

FAQPage Schema
How do I keep documentation from drifting out of sync with the codebase?

To prevent documentation drift, review knowledge base entries against current code and architecture reality. This process classifies each entry as keep, update, consolidate, replace, or delete using evidence instead of guesswork.

What is the best way to deduplicate overlapping stale learnings in a knowledge base?

Deduplicating stale learnings requires an evidence-first review that identifies overlapping entries and consolidates them. This ensures shipped work supersedes contradicted guidance while maintaining an accurate library.

How do I review compound learnings against current repository reality?

Reviewing compound learnings against repository reality involves evaluating docs/compound entries using evidence-first classification. You classify each reviewed item as keep, update, consolidate, replace, delete, or mark it stale when confidence is low.

Can I generate recommendations before applying changes to my knowledge base?

Yes, you can run the review in propose mode to generate recommendations without modifying files. This controlled change application reports suggested actions for updating, consolidating, replacing, or archiving entries supported by evidence.

Does the documentation maintenance workflow produce an audit report?

Yes, the workflow produces a timestamped refresh report in the docs/closure directory. This accountable report summarizes the gathered evidence, actions taken, and necessary follow-ups for future reference.

When should I mark a knowledge base entry as stale instead of deleting it?

You should mark a knowledge base entry as stale when confidence is low during the evidence review. This flags overlapping or outdated guidance for future consolidation rather than permanently deleting potentially useful information.