sweep-heat — Claude Code skill: what it does, how to install
The sweep-heat Claude Code skill marks cold notes in the bottom 20 of HEAT_INDEX.md as dormant. Run it to inspect the heat index or change note statuses.
MIT ★ 26 updated 2026-11-16
npx skills add wrg32786/aigent-os --skill sweep-heat -a claude-codeWhat sweep-heat does
The skill reads memory/HEAT_INDEX.md or a supplied path and finds the 20 notes with the lowest access and link frequency scores. It checks each note’s frontmatter, then adds or changes status to dormant when the note qualifies.
Notes marked active, pinned, protected or dormant are skipped, along with third-party files, tool configuration, LICENSE and files outside the vault. The skill edits only the status field and returns counts for changed and skipped notes. It does not use Bash, Agent or WebFetch, and creates no files.
What it helps with
- find 20 notes with the lowest access and link frequency scores
- mark eligible cold notes as
dormant - skip active, protected and third-party files
- get counts of changed and skipped notes
Example prompts for the agent
- Sweep
HEAT_INDEX.mdand mark eligible cold notes as dormant. - Check
memory/HEAT_INDEX.mdand flip qualifying notes to dormant. - Run a heat index sweep and report the changed-note counts.
How to install sweep-heat
1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill sweep-heat -a claude-code2Manually: put the files in place
~/.claude/skills/sweep-heat/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sweep-heat/
1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill sweep-heat -a codex2Manually: put the files in place
.agents/skills/sweep-heat/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill sweep-heat -a cursor2Manually: put the files in place
.cursor/skills/sweep-heat/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/sweep-heat2Manually: put the files in place
.github/skills/sweep-heat/SKILL.md1Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill sweep-heat -a gemini-cli2Platform CLI
gemini skills install https://github.com/wrg32786/aigent-os --path skills/sweep-heatManually: put the files in place
.devin/skills/sweep-heat/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill sweep-heat -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sweep-heat
How do I install sweep-heat in Claude Code?
Run npx skills add wrg32786/aigent-os --skill sweep-heat -a claude-code. The skill file is at ~/.claude/skills/sweep-heat/SKILL.md.
What does sweep-heat do?
It checks the 20 notes with the lowest scores in HEAT_INDEX.md, changes the eligible status field to dormant, and reports counts.
Which notes does sweep-heat skip?
It skips notes marked active, pinned, protected or dormant, plus third-party files, tool configuration, LICENSE and files outside the vault.
Source text
SKILL.md · MIT
--- name: sweep-heat agent: hestia description: "Mark cold bottom-20 HEAT_INDEX.md notes dormant and report counts. Use when sweeping cold notes, checking the heat index, or flipping dormant status." allowed-tools: Read, Edit, Grep, Glob user-invocable: true triggers: - sweep heat - heat index sweep - flip dormant - mark dormant - cold notes sweep - HEAT_INDEX sweep - sweep cold notes - dormant flip --- # Sweep Heat You are Hestia sweeping the HEAT_INDEX and flipping cold notes to dormant. Terse. Factual. No editorializing. ## What this skill does Read `memory/HEAT_INDEX.md` (or the path specified). Identify the cold bottom-20 notes. Add `status: dormant` to their frontmatter. Return counts of what was flipped. ## Protocol ### Step 1: Read HEAT_INDEX Read `memory/HEAT_INDEX.md` to identify the bottom-20 cold notes. These are the notes with the lowest access/link frequency scores. ### Step 2: Read each cold note's frontmatter For each of the bottom-20 notes, Read the file to check current frontmatter. Specifically look for the `status:` field. ### Step 3: Flip eligible notes A note is eligible for dormant flip if: - It has a `status:` field (or no status field — add one) - Its current status is NOT `active`, `pinned`, `protected`, or `dormant` - It is a vault note (not a third-party file, tool, or LICENSE) Use Edit to add or update: `status: dormant` Skip: third-party files, tool config files, LICENSE files, files outside the vault. ### Step 4: Return report (terse) ``` ## Heat Sweep — YYYY-MM-DD Bottom-20 scanned: 20 Flipped to dormant: N Skipped (already dormant): N Skipped (protected/active/pinned): N Skipped (non-vault file): N ``` ## Constraints - Edit only the `status:` frontmatter field. No content edits. - No Write tool. No new files. - No Bash, no Agent, no WebFetch. - Third-party files are never touched. - Report is counts and brief list only. No prose.
© wrg32786 · MIT · wrg32786/aigent-os