nap

Name: nap
Availability: InStock
Author: nicolehaugen

Compress agent histories, archive decisions, and prune logs in .squad/ state.

Updated Apr 8, 2026

Search Tags:#context management #archiving #pruning #nap #squad state maintenance

Ready to run

npx skills add https://github.com/nicolehaugen/CustomMetricsDashboard --skill nap-nicolehaugen

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: nap
Source: https://github.com/nicolehaugen/CustomMetricsDashboard/tree/main/.squad/templates/skills/nap
Command: npx skills add https://github.com/nicolehaugen/CustomMetricsDashboard --skill nap-nicolehaugen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Over time, your .squad/ state can grow to an impractical size. The 'nap' skill helps by compressing histories, pruning logs, archiving decisions, and cleaning up to prevent bloat.

Core Features & Use Cases

Context Compressing: Compress agent histories and archive stale decisions to manage the context effectively.
Pruning: Prune old logs to prevent .squad/ from getting too large.
Use Case: Run 'squad nap' to optimize the .squad/ size when preparing for intensive or many-agent operations.

Quick Start

Perform a lightweight 'nap' by executing: squad nap

Frequently Asked Questions about nap

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

FAQPage Schema

How do I free up context space in my squad state before running intensive operations?▼

To free up context space, compress agent histories and prune old logs using a context cleanup command. This optimizes squad state size by archiving stale decisions and clearing unnecessary files to prevent bloat during large-scale operations.

What is the best way to prevent squad state bloat during many-agent fan-out operations?▼

The best way to prevent squad state bloat is compressing histories and pruning logs beforehand. Archiving old decisions and cleaning up files ensures efficient state management for larger scale or fan-out operations.

When should I prune logs and archive decisions in my squad directory?▼

Prune logs and archive decisions when your squad state grows to an impractical size. This context management step is useful before intensive tasks to free up space and ensure efficient operation handling.

How do I compress agent histories to manage squad state effectively?▼

Compress agent histories by running a lightweight nap command that targets the squad directory. This compresses histories, archives stale decisions, and prunes old logs to manage context effectively and prevent bloated state files.

Can I clean up squad state files without losing important agent decisions?▼

Yes, you can clean up squad state files without losing important decisions by archiving old decisions rather than deleting them. This process compresses histories and prunes logs while preserving archived decision records for future reference.