Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill sweep-heat -a claude-code
Open on GitHub

What 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.md and mark eligible cold notes as dormant.
  • Check memory/HEAT_INDEX.md and 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-code

2Manually: put the files in place

~/.claude/skills/sweep-heat/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sweep-heat/

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

Similar skills

SKILL.md skills catalog →

From the same set58

The whole set →
frontend-slides The frontend-slides Claude Code skill creates animated HTML presentations and converts PowerPoint files into browser-ready slides. It activates for slide decks, talks, pitches, and PPT/PPTX web conversions. CX Codex +1 ★ 26repo stars sweep-links The sweep-links skill for Claude Code finds wikilinks that point to missing notes. Run it to scan a vault or locate dead links. CX Codex +1 ★ 26repo stars supersede The supersede Claude Code skill replaces outdated vault-note entries while retaining their history. The agent uses it for requests to update a note or mark a claim as no longer true. CX Codex +1 ★ 26repo stars Stuck The Stuck Claude Code skill guides an agent through possible next steps before it calls a task blocked. It activates when the agent runs out of ideas or is about to ask for help. CX Codex +1 ★ 26repo stars status The status Claude Code skill reports the current operating state of aigent-OS. Ask for a snapshot of its mode, objective, next action, or blockers. CX Codex +1 ★ 26repo stars start start — a Claude Code skill that opens a home screen on first launch or when work resumes. It guides setup or gives a brief status update with an action menu. CX Codex +1 ★ 26repo stars sprite-spec This Claude Code skill turns pixel-art character ideas into sprite specifications. It activates for character or sprite-sheet design, covering palettes, proportions, and animation states. CX Codex +1 ★ 26repo stars solution-hunt The solution-hunt Claude Code skill finds legitimate alternatives when a task hits a blocker. It searches local notes and skills, then looks through GitHub and documentation. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open