workspace-file-edit

Edit SOUL.md, USER.md, and BOOTSTRAP.md with whitelist enforcement and plan confirmation.

6|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Acosmi/CrabClaw --skill workspace-file-edit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-file-edit
Source: https://github.com/Acosmi/CrabClaw/tree/main/docs/skills/tools/fs/workspace-file-edit
Command: npx skills add https://github.com/Acosmi/CrabClaw --skill workspace-file-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables you to edit workspace persona files (SOUL.md, USER.md, BOOTSTRAP.md) to update agent identity, user preferences, and bootstrap configurations, when requested by the user.

Core Features & Use Cases

  • Edit workspace persona files (SOUL.md, USER.md, BOOTSTRAP.md) to update persona, user profile, and bootstrap guidance.
  • Enforce a strict whitelist of editable files and require plan confirmation before applying changes.
  • Changes take effect immediately after write; memory system continues to manage MEMORY.md automatically.

Quick Start

Read the current SOUL.md/USER.md/BOOTSTRAP.md, craft the new content, then apply it with the Workspace File Edit tool.

Frequently Asked Questions about workspace-file-edit

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

FAQPage Schema
How do I edit workspace persona files to update AI identity?

To edit workspace persona files, you modify SOUL.md, USER.md, and BOOTSTRAP.md to update agent identity, user preferences, and bootstrap configurations. The system requires a plan confirmation before applying any write operations to ensure safe updates.

What is the process for modifying SOUL.md and USER.md configurations?

Modifying SOUL.md and USER.md configurations involves reading the current files first, crafting the new content, and applying it through the Workspace File Edit tool. Changes take effect immediately after write for runtime use.

Can I edit any file in the workspace to change my agent's profile?

No, you cannot edit any file freely. The system enforces a strict whitelist of editable files limited to SOUL.md, USER.md, and BOOTSTRAP.md. This restriction ensures only authorized persona and configuration files are modified.

How does plan confirmation work when updating bootstrap configurations?

Plan confirmation requires you to approve the proposed changes before the system writes to BOOTSTRAP.md. This gating mechanism reads current files first, then waits for your confirmation to apply the bootstrap guidance updates immediately at runtime.

Does the workspace file editor manage MEMORY.md automatically?

No, the workspace file editor does not manage MEMORY.md. The memory system continues to manage MEMORY.md automatically, while this skill strictly handles editing SOUL.md, USER.md, and BOOTSTRAP.md files.

What are the limitations of editing workspace persona files?

Limitations of editing workspace persona files include the strict whitelist restricting edits to only SOUL.md, USER.md, and BOOTSTRAP.md, and the mandatory plan confirmation step required before any write operation can be executed.