Context compression
Skill dzhokhov/markdown-agent-vault/skills/context-compression
Agent-ready Markdown vault methodology with AGENTS.md, templates, skills, logs, and file-safe workflows.
npx -y skills add dzhokhov/markdown-agent-vault --skill context-compressionAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 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
Maintains a compressed meetings/README.md for recurring meetings and long-lived contours. Use when a project has 3+ meeting summaries, when a decision is reversed, when a new meeting should update the rolling context, or when the agent would otherwise need to read the full meetings folder.
SKILL.md
3.2 KB, as published. Nobody here has run it
Context Compression
Purpose
Keep long meeting history usable without reading every meeting file. The skill builds and updates a compressed meetings/README.md that separates recent meetings, active decision chains, stale agreements, open questions, and anchor sources.
When To Use
Use this skill:
- before processing a regular meeting when the folder has three or more summaries;
- after adding a new meeting summary to a recurring project or contour;
- when a decision is reversed or superseded;
- when the owner asks for a catch-up across many meetings;
- when a future agent needs a short current history instead of a full archive scan.
Do not use it for one-off meetings with no ongoing thread.
Required Inputs
- Target project or contour.
- Meetings folder path.
- Existing
meetings/README.md, if present. - New meeting summary, if the task follows a meeting.
- Project
README.md,context.md, and current picture if available.
Output File
Default output:
<project-or-contour>/meetings/README.md
Compression Model
The compressed index must include:
- Latest meetings - most recent entries with links and why they matter.
- Active decision chains - current decisions and the meetings that led to them.
- Stale or superseded agreements - old decisions that should not guide current work.
- Open questions - unresolved issues, owner questions, or missing sources.
- Anchor sources - meetings that remain important even if old.
- Update rule - when the file should be rebuilt again.
Rules
- Do not treat frequency as truth.
- Do not turn a participant's comment into a decision without authority.
- Preserve disagreement and reversals.
- Prefer links to source meetings over long copied summaries.
- Keep the compressed file compact enough to be read before future meetings.
- If a claim is important and uncertain, mark it as such instead of smoothing it.
Update Procedure
- Read project or contour entry files.
- Read the existing compressed meetings index if present.
- Read only the meeting summaries needed for the update.
- Identify new decisions, reversed decisions, stale agreements, and open questions.
- Update
meetings/README.md. - If the current project or contour picture changed, update it according to vault-memory.
- Record a short event in
log.mdif the update changes project state.
Quality Check
Before finishing, verify:
- all meeting links resolve;
- old agreements are not presented as current;
- new decisions have source links;
- open questions are explicit;
- the file is shorter than reading the full meeting archive.
Next step
After updating the compressed index, continue the meeting-processing or project task that triggered the compression.