Clawdbot Workspace Template Review

Compare a Clawdbot workspace against the official templates installed with Clawdbot (npm or source) and list missing sections to pull in, especially after upgrades.

Security Scan

The skill is an instruction-only tool that reads local Clawdbot template files and the user’s workspace markdown files to report missing sections — its requirements and instructions are consistent with that purpose.

Purpose & Capability

Name and description claim a workspace-vs-template comparison; the SKILL.md only requires locating the installed Clawdbot source root and reading template and workspace markdown files to compute diffs. No unrelated credentials, installs, or external services are requested.

Instruction Scope

Instructions direct the agent to run local commands (command -v, npm root -g, sed, diff) and to open files under the Clawdbot install and the user's workspace. This is expected for the stated task, but it does require the agent to read arbitrary local files in the indicated paths — ensure you’re comfortable with the agent having that filesystem access.

Install Mechanism

No install spec and no code files — instruction-only. Nothing will be written to disk by an installer as part of this skill.

Credentials

The skill declares no environment variables, credentials, or config paths. The instructions mention standard system/npm paths and commands only; there are no disproportionate credential requests.

Persistence & Privilege

always is false and disable-model-invocation is false (normal). The skill does not request persistent presence or to modify other skills/system-wide settings.

Assessment

This skill is instruction-only and consistent with its stated purpose: it needs to read your Clawdbot install directory and your workspace markdown files to compute diffs. Before enabling or running it, consider: 1) it will access local file paths (node_modules, your workspace) — don't run it if you have sensitive files in those locations you don't want an agent reading; 2) because the skill can be invoked autonomously (platform default), only enable it for agents you trust; 3) you can manually perform the suggested commands (command -v, npm root -g, sed, diff) if you prefer to avoid giving the agent filesystem access; and 4) there is no network or credential access requested by the skill. If you want higher assurance, run these steps yourself or inspect any future code files before granting runtime access.

Workspace Template Diff

Use this skill when the user wants to compare their workspace .md files (AGENTS, SOUL, USER, IDENTITY, TOOLS, HEARTBEAT, etc.) against the official Clawdbot templates, then review missing sections and decide what to add.

Locate the official templates

Find the installed Clawdbot source root:

• If clawdbot is installed via npm/pnpm globally:
  • command -v clawdbot
  • If it points into .../node_modules/.bin/, resolve to the sibling node_modules/clawdbot
  • Or use npm root -g / pnpm root -g and look for clawdbot/
• If Clawdbot runs from source, use that checkout root (must contain package.json).

Templates live at:

<clawdbot-root>/docs/reference/templates/

If you can’t find the source root, ask the user where their Clawdbot is installed.

Comparison workflow

1. Identify the workspace root (the user’s “our version” directory).
2. For each template file in docs/reference/templates (skip *.dev.md):
   • Open the official template and the workspace file with the same name.
   • Ignore template frontmatter (--- block) and any “First Run”/“Bootstrap” sections.
   • Compare the remaining sections and list any missing blocks.

Helpful commands (use ad‑hoc CLI tools like diff):

ls <clawdbot-root>/docs/reference/templates
sed -n '1,200p' <clawdbot-root>/docs/reference/templates/AGENTS.md
sed -n '1,200p' <workspace>/AGENTS.md
diff -u <clawdbot-root>/docs/reference/templates/AGENTS.md <workspace>/AGENTS.md

When reporting diffs:

• Show the missing sections verbatim from the official template.
• Explain briefly why they matter, then ask whether to add them.
• Move file by file; skip files that only differ by frontmatter or bootstrap content.

Output format

Use the “missing section” format we used previously:

• File path
• Missing block(s)
• Suggestion + question to proceed