clawdbot-workspace-template-review

What This Skill Does

The clawdbot-workspace-template-review skill acts as a configuration guardian for your Clawdbot project. As the Clawdbot framework evolves, official templates for core configuration files—such as AGENTS, SOUL, USER, IDENTITY, TOOLS, and HEARTBEAT—are updated to include new parameters, improved structure, or critical documentation blocks. This skill automatically detects your Clawdbot installation directory, compares your active workspace files against the latest upstream templates, and identifies specific missing sections that could be hindering your agent's performance or missing new functionality.

Installation

To install this skill, run the following command in your terminal within your Clawdbot environment:

clawhub install openclaw/skills/skills/xadenryan/clawdbot-skill-clawdbot-workspace-template-review

Ensure your project is configured with standard Clawdbot file structures for the best results.

Use Cases

This tool is essential for developers maintaining long-term Clawdbot projects. Use it immediately after upgrading your Clawdbot dependencies to ensure your local files are synchronized with the latest framework requirements. It is also useful when you feel your agent's behavior is inconsistent or if you are debugging issues related to missing metadata fields that standard templates now require. It streamlines the upgrade process by isolating only the delta, preventing the need for manual, error-prone line-by-line file comparisons.

Example Prompts

1. "Run a workspace review. I just upgraded my Clawdbot version and I want to see which of my configuration files are missing new sections."
2. "Compare my AGENTS.md and SOUL.md against the official templates and tell me if I'm missing any crucial fields."
3. "I'm getting errors in my heartbeat. Can you use the workspace-template-review skill to check if my HEARTBEAT.md is outdated?"

Tips & Limitations

The skill performs a structural diff of markdown files, ignoring boilerplate frontmatter and bootstrap instructions to focus on relevant configuration blocks. If you use custom file paths for your configuration, ensure the skill is pointed at your workspace root correctly. Please note that this skill performs read operations on your local filesystem and compares them against the source root. It will not automatically modify your files; it provides a suggested 'merge' path that you must review and approve. Always back up your configuration files before performing any automated updates recommended by the diff output.