filesystem-context

Manage agent context by offloading tool outputs and plans to files.

3|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/boazcstrike/opencode --skill filesystem-context-boazcstrike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: filesystem-context
Source: https://github.com/boazcstrike/opencode/tree/main/skills/filesystem-context
Command: npx skills add https://github.com/boazcstrike/opencode --skill filesystem-context-boazcstrike

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides strategies to overcome the limitations of fixed context windows by leveraging the filesystem for dynamic context loading, state persistence, and efficient information retrieval.

Core Features & Use Cases

  • Offload Large Outputs: Store massive tool outputs (e.g., search results, logs) in files instead of the context window.
  • Persistent Plans: Save and reload multi-step plans to maintain task continuity across long interactions.
  • Dynamic Skill Loading: Load skill instructions only when needed, reducing static context bloat.
  • Sub-Agent Communication: Enable agents to share information via a shared filesystem workspace.
  • Use Case: When a web search returns thousands of tokens, this skill saves the output to a file and provides a summary and path, allowing the agent to retrieve specific details on demand without exceeding context limits.

Quick Start

Use the filesystem-context skill to save large tool outputs to files for later retrieval.

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 tool outputs exceed the context window limits?

To manage agent context beyond fixed window limits, you can offload massive tool outputs like search results or logs to the filesystem. This allows the agent to retrieve specific details on demand without exceeding context limits.

What is the best way to maintain state persistence for multi-step agent plans?

State persistence for multi-step plans is achieved by saving and reloading plans to the filesystem. This maintains task continuity across long interactions by storing structured data in files for later retrieval.

Can I use filesystem operations for sub-agent communication?

Yes, sub-agent communication is enabled by utilizing a shared filesystem workspace. Agents can share information dynamically by writing to and reading from common files within the workspace.

How do I reduce static context bloat from dynamically loaded skills?

To reduce static context bloat, load skill instructions dynamically only when needed. By utilizing the filesystem for context discovery, agents retrieve specific instructions on demand rather than holding them in memory.

Does filesystem-based context management work for retrieving specific details from large logs?

Yes, when web searches or logs return thousands of tokens, the skill saves the output to a file and provides a summary and path. Agents then use file-based operations like grep and read_file to retrieve specific details on demand.

What are the limitations of using the filesystem for dynamic context discovery?

Using the filesystem for dynamic context discovery requires available local storage and file access permissions. While it overcomes context window bloat, agents must execute file operations like grep and read_file to retrieve information, adding operational overhead.