skills.rest
seiggy
seiggyCOMMUNITY
Explore all skills by this author →
GitHub

nap

Compresses agent histories, prunes logs, and archives stale .squad state files.

1|Updated Jul 7, 2026
Search Tags:#maintenance#compression#archiving#agent state#state cleanup#context hygiene#log pruning
One-click install
npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill nap-seiggy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nap
Source: https://github.com/seiggy/maf-copilot-studio-demo/tree/main/.squad/templates/skills/nap
Command: npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill nap-seiggy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running agent sessions accumulate large history files, stale decisions, and orphaned inbox files that consume context window budget and slow down workflows. This Skill reclaims that budget by compressing, pruning, and archiving .squad/ state. ## Core Features & Use Cases - History Compression: Compresses agent history.md files that exceed 15KB to free context window space. - State Pruning & Archiving: Prunes old logs, archives stale decisions, and cleans orphaned inbox files when .squad/ exceeds 1MB. - Dry-Run & Deep Modes: Preview changes with --dry-run before applying, or run --deep for thorough cleanup. - Use Case: Before launching a heavy fan-out workflow with many spawned agents, run a nap cycle to reclaim context budget and start with a clean state. ## Quick Start Run squad nap --dry-run to preview what state files would be compressed and archived before committing to the cleanup.

Frequently Asked Questions about nap

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

FAQPage Schema
How do I clean up .squad state files?▼

Run squad nap from the CLI or /nap from the REPL to compress agent histories, prune old logs, and archive stale decisions. Use the --dry-run flag first to preview changes before applying them.

When should I run context hygiene on agent state?▼

Run it before heavy fan-out work where many agents will spawn, when history.md files exceed 15KB, when the .squad directory exceeds 1MB, or after long-running sessions and sprints.

What is the difference between nap and nap --deep?▼

The standard nap command performs routine compression and pruning of .squad state. The --deep flag triggers a more thorough cleanup pass for heavily accumulated state, while --dry-run previews either mode without making changes.

Can I preview nap cleanup without deleting files?▼

Yes, use squad nap --dry-run or /nap --dry-run to see exactly which histories, logs, and inbox files would be compressed or archived. No changes are applied until you run the command without the flag.

Does nap delete agent decision records permanently?▼

Nap archives stale decisions rather than permanently deleting them, and cleans orphaned inbox files. Running with --dry-run first lets you confirm which records will be archived before proceeding.

Related Skills

Explore More Software Engineering Skills→
githubgithub
5.1k

nap

Compresses, prunes, and archives .squad/ state to reclaim context window budget.

Official
Basic
usepowershellusepowershell
9

nap

Compress, prune, and archive agent histories in .squad state directories.

Community
Intermediate
fractaryfractary

log-archiver

Archive logs to cloud storage with path-based retention policies and an archive index.

Official
Advanced
moltis-orgmoltis-org
2.8k

findmy

Automates Apple device and AirTag location tracking via FindMy app.

Official
Intermediate