init

Scan the filesystem sandbox and store a file catalog in world_state.

10|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill init-bdambrosio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/bdambrosio/Cognitive_workbench/tree/main/src/world-tools/fs/init
Command: npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill init-bdambrosio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool provides the AI agent with an immediate understanding of the available files and directories within its sandbox environment, preventing it from operating in a vacuum.

Core Features & Use Cases

  • Filesystem Awareness: Automatically scans and catalogs the directory structure and file types.
  • Contextual Information: Includes summaries from directory documentation files (Skill.md, README.md, DIRECTORY.md).
  • Use Case: Before an agent attempts to find a specific configuration file, this tool ensures it knows where to look and what files are present in the relevant directories.

Quick Start

Use the init skill to build the filesystem catalog for the current world.

Frequently Asked Questions about init

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

FAQPage Schema
How do I give an AI agent filesystem awareness of available files and directories?

To give an AI agent filesystem awareness, you need to catalog the sandbox environment. This skill scans directory structures, detects file formats, and stores the catalog in world_state for executor retrieval.

How do I initialize a filesystem catalog for prompt context?

You initialize a filesystem catalog for prompt context by running a directory scan with limited depth and entry limits. The scan detects file formats and extracts summaries from documentation files like Skill.md, README.md, and DIRECTORY.md.

Does the filesystem catalog scan include directory documentation summaries?

Yes, the filesystem catalog scan includes directory documentation summaries. It automatically detects and incorporates content from Skill.md, README.md, and DIRECTORY.md files to provide contextual information about the directories.

What are the limitations of scanning a sandbox filesystem for agent awareness?

The limitations of scanning a sandbox filesystem include restricted depth and entry limits during the directory scan. These constraints prevent exhaustive traversal, meaning deeply nested files may be excluded from the resulting world_state catalog.

Why does my AI agent operate in a vacuum without filesystem awareness?

An AI agent operates in a vacuum without filesystem awareness because it lacks a catalog of available files and directories. Initializing a sandbox scan builds the necessary prompt context so the agent knows where to locate files.