skills.rest
elbruno
elbrunoCOMMUNITY
Explore all skills by this author →
Website𝕏@elbrunoGitHub

nap

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

2|Updated Jul 24, 2026
Search Tags:#multi-agent#maintenance#compression#archiving#agent history#state cleanup#context hygiene
One-click install
npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill nap-elbruno
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nap
Source: https://github.com/elbruno/ElBruno.MagenticUI/tree/main/.squad/templates/skills/nap
Command: npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill nap-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running multi-agent sessions accumulate large history files, stale decisions, and orphaned inbox files that consume context window budget and slow down agent workflows. ## Core Features & Use Cases - History Compression: Compresses agent history.md files that exceed 15KB to reclaim context budget. - State Archival: Archives stale decisions and cleans orphaned inbox files in the .squad/ directory. - Dry-Run and Deep Modes: Preview changes with --dry-run or perform thorough cleanup with --deep. - Use Case: Before spawning many agents for a fan-out task, run a cleanup pass to free context window space and keep the .squad/ directory under 1MB. ## Quick Start Run the nap skill in dry-run mode to preview which .squad state files would be compressed, pruned, or archived.

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 what will change before applying cleanup.

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, pruning, and archiving of .squad state. The --deep flag triggers a more thorough cleanup pass for heavily accumulated state.

Can I preview nap cleanup without deleting anything?▼

Yes, use squad nap --dry-run or /nap --dry-run to preview which files would be compressed, pruned, or archived without making any changes to the .squad directory.

Does nap delete agent decision records permanently?▼

Nap archives stale decisions rather than permanently discarding them, and cleans orphaned inbox files. Running with --dry-run first lets you confirm exactly what will be affected.

Related Skills

Explore More Software Engineering Skills→
githubgithub
5.1k

agent-collaboration

Standardizes worktree awareness, decision recording, and cross-agent communication patterns for squad agents.

Official
Basic
JenilRevaliyaJenilRevaliya

agent-organizer

Orchestrates multi-agent workflows with delegation patterns, state management, and execution loops.

Community
Advanced
dotnetdotnet
209

nap

Compress agent histories, prune logs, and archive stale decisions.

Official
Intermediate
fractaryfractary

log-archiver

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

Official
Advanced