filesystem-context

Store and retrieve agent context using filesystem tools.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/aldy505/atrium --skill filesystem-context-aldy505
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: filesystem-context
Source: https://github.com/aldy505/atrium/tree/main/.agents/skills/context-engineering-collection/skills/filesystem-context
Command: npx skills add https://github.com/aldy505/atrium --skill filesystem-context-aldy505

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the limitations of fixed context windows by enabling agents to store, retrieve, and manage effectively unlimited context using the filesystem, preventing context bloat and enabling dynamic discovery of information.

Core Features & Use Cases

  • Offload Large Outputs: Store massive tool outputs (e.g., search results, logs) to files, returning only a summary and reference to the context.
  • Persistent Planning: Save agent plans to files, ensuring they remain accessible across long-running tasks even after context window resets.
  • Dynamic Skill Loading: Load skill definitions from files on demand, keeping the static context lean and relevant.
  • Sub-Agent Communication: Facilitate inter-agent communication by having agents write findings to shared filesystem locations.
  • Use Case: An agent performing a complex web scraping task generates gigabytes of raw HTML. Instead of filling the context window, the agent writes the HTML to a file and includes a reference, allowing it to selectively retrieve specific data later using grep or file reading tools.

Quick Start

Use the filesystem-context skill to save a large tool output to a file and get a reference back.

Frequently Asked Questions about filesystem-context

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

FAQPage Schema
How do I manage agent context when it exceeds fixed window limits?

You can manage agent context by offloading large tool outputs and persisting plans to the filesystem. This approach leverages file storage to prevent context bloat and enables dynamic information retrieval using tools like `ls`, `glob`, `grep`, and `read_file`.

What is the best way to store large tool outputs without filling the context window?

The best way to store large tool outputs is writing them to files and returning a summary with a reference. Agents can then selectively retrieve specific data later using grep or file reading tools, keeping the active context lean and relevant.

Can agents use the filesystem to share findings and communicate with each other?

Yes, agents can use the filesystem for sub-agent communication by writing findings to shared locations. This file-based exchange facilitates inter-agent coordination without relying on direct context window sharing.

How do I load skill definitions on demand to keep context lean?

You can load skill definitions dynamically from files on demand. This dynamic loading approach ensures that the static context remains lean by only retrieving and applying skill definitions when they are explicitly required.

How does persistent planning work for long-running tasks across context window resets?

Persistent planning works by saving agent plans to files, ensuring they remain accessible across long-running tasks. This prevents plan loss even after context window resets, allowing agents to resume operations seamlessly.

What tools are used for dynamic context discovery and management in the filesystem?

Dynamic context discovery utilizes tools like `ls`, `glob`, `grep`, and `read_file` for filesystem context management. These tools enable agents to navigate directories, search file contents, and retrieve specific data references efficiently.