filesystem-context

Offload oversized context data to filesystem files with grep/read_file retrieval.

17.7k|1.5k|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering --skill filesystem-context-muratcankoylan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: filesystem-context
Source: https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/filesystem-context
Command: npx skills add https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering --skill filesystem-context-muratcankoylan

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The filesystem-based approach enables dynamic context discovery by offloading large tool outputs and long-term state to files, reducing prompt window bloat and keeping the core prompt lean.

Core Features & Use Cases

  • Scratch Pad Manager for large tool outputs with concise file references
  • Plan persistence to preserve long-horizon tasks across context refreshes
  • Sub-agent workspaces and filesystem-backed memory for cross-agent collaboration
  • Dynamic skill loading to load only relevant content when needed
  • Terminal and log persistence for targeted querying
  • Safe self-modification and guardrails for evolving preferences Use cases include persistent task tracking, long-running experiments, and memory systems for agents.

Quick Start

Write a large tool output to scratch/tool_output_<timestamp>.txt and reference the path in the agent context to demonstrate on-demand retrieval.

Frequently Asked Questions about filesystem-context

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

FAQPage Schema
How do I offload large tool outputs to the filesystem to reduce agent prompt bloat?

To reduce agent prompt bloat, offload large tool outputs to the filesystem by writing them to a scratch pad file and referencing the file path in the agent context for on-demand retrieval. This keeps the core prompt lean while preserving data.

What is the best way to persist multi-step agent plans across context window refreshes?

The best way to persist multi-step plans across context refreshes is using plan persistence features that save long-horizon task states to the filesystem. This ensures continuous task tracking without losing progress during context resets.

Can I use a filesystem-backed scratch pad for cross-agent information sharing?

Yes, you can use filesystem-backed memory and sub-agent workspaces for cross-agent information sharing. By storing shared state in files, multiple agents can dynamically discover and retrieve context using grep and read_file style operations.

When do I need dynamic context discovery for long-running agent tasks?

You need dynamic context discovery for long-running agent tasks when oversized tool outputs and long-term state exceed the prompt window. Offloading this data to files allows the agent to load only relevant content dynamically when needed.

Does this approach support safe self-modification and guardrails for evolving agent preferences?

Yes, this approach implements safe self-modification and guardrails for evolving agent preferences. It allows agents to securely update their behavioral state stored in the filesystem while maintaining operational safety boundaries.