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