File and Project Skills

These skills handle file system operations and project-scoped actions. They allow tools to read secondary files, write output, list directories, and search for files.

Project Skills (Available to Tools)

ReadFile

Read a secondary file by path.

Parameters:

  • filePath (string, required) — Path to the file to read

Important: Never use ReadFile for the tool's primary input. Primary input is already in the structured tool data. ReadFile is for a second file. A fixed filePath is used directly; when it is omitted, the skill extracts one path from the current structured data and rejects ambiguous multiple paths.

WriteFile

Save output to a file.

Parameters: None required.

Behavior: Path, filename, format, and content are resolved automatically by the system from the tool's settings, the output destination supplied by the caller, and the active project context. The content written is the previous step's output.

When the caller supplies an output folder, the skill writes a new file named from the tool name and a timestamp. When the caller supplies an existing document instead, the runtime targets that document and appends to it under a heading naming the tool and the run time.

A step may declare an explicit filePath argument, which overrides both cases. See Tool Output and Results for the full resolution order and its known limitation around documents open in the editor.

ListFiles

List files in a directory.

Parameters:

  • path (string, required) — Directory path to list
  • filter (string, optional) — Glob filter pattern (e.g. *.md)

Important: Not for primary input discovery. Use only when the tool's task requires browsing a location to decide what to process.

GetFileInfo

Get metadata about a file.

Parameters:

  • filePath (string, required) — Path to the file

Returns: File size, dates (created, modified), file type, and other metadata. A fixed filePath is used directly; when it is omitted, the skill extracts one path from the current structured data and rejects ambiguous multiple paths.

SearchFiles

Search for files matching a pattern within the project.

Parameters:

  • pattern (string, required) — Search pattern (glob or name pattern)
  • searchContent (bool, optional) — Also search within file content

File System Skills (System-Only)

These exist but are not available to user-created tools. ThinkForge uses them internally.

CopyFile

Copy a file from one location to another.

Parameters: sourcePath, destinationPath, overwrite

MoveFile

Move or rename a file.

Parameters: sourcePath, destinationPath

DeleteFile

Delete a file. Requires confirmation.

Parameters: filePath, confirmed

CreateDirectory

Create a new directory.

Parameters: directoryPath

These are excluded from the planner's view because file management operations are dangerous and better handled explicitly by users or system automation, not by AI-planned tools.