Clawdit: Agent Belief Systems Auditor for Openclaw

Clawdit is a systematic auditing tool designed to align an AI agent's internal belief system and context files with the user's actual goals.

mcroebuck
v1.1.0
Mar 27, 2026
0
814
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install clawdit

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install clawdit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Clawdit: Agent Belief Systems Auditor?

Clawdit is a specialized utility within the Openclaw Skills ecosystem that serves as a belief systems auditor. It systematically evaluates an agent's loaded context—including SOUL.md, AGENTS.md, and individual skill files—to ensure every instruction serves a specific purpose. By treating agent files as data rather than just instructions, Clawdit identifies misalignments, stale configurations, and redundant directives that inflate token usage.

The skill operates through a rigorous five-phase process that moves from goal elicitation to cross-file conflict detection. It helps developers maintain a lean, high-performance agent by providing a clear audit trail and recommended revisions for better identity consistency and operational efficiency.

Clawdit: Agent Belief Systems Auditor Use Cases

  • Aligning an agent's behavior with new project goals or personal preferences.
  • Reducing token costs by identifying and removing redundant or vague instructions.
  • Resolving personality or logic conflicts between the core SOUL.md and specific skill directives.
  • Modernizing agents by pruning stale references to deprecated tools, APIs, or models.
  • Troubleshooting agent 'drift' where the AI begins to prioritize the wrong tasks or styles.

How Clawdit: Agent Belief Systems Auditor Works

  1. Goal Elicitation: The auditor interviews the user to establish a success rubric, ensuring it understands the intended purpose before reading any files.
  2. Belief Extraction: Clawdit scans the workspace to decompose markdown files into discrete belief units, tracking their source, type, and intent.
  3. Single-File Analysis: Each belief is classified (e.g., Aligned, Stale, Vague) against the established goals to determine its utility.
  4. Cross-File Analysis: The system checks for tone inconsistencies, priority inversions, and identity fragmentation across different configuration files.
  5. Collaborative Review: A detailed audit report is generated, allowing the user to review findings and approve specific revisions or file updates.

Clawdit: Agent Belief Systems Auditor Setup

To install this skill into your agent workspace, use the Openclaw CLI:

openclaw install clawdit

Ensure the audit framework is present in your base directory at audit-framework.md to provide the necessary classification definitions and report templates.

Clawdit: Agent Belief Systems Auditor Data Schema & Taxonomy

Clawdit organizes its auditing data and outputs using the following structure:

File/Folder Description
USER.md Stores the 'Goals for Belief Auditing' and history of prior audits for fast-path re-auditing.
/audits/audit-YYYY-MM-DD.md Permanent historical record of the full audit findings and classifications.
/output/ Staging area for revised .md files before they are deployed to the target agent.
audit-framework.md The core taxonomy and evaluation criteria used to score beliefs (B001, B002, etc.).

Clawdit: Agent Belief Systems Auditor Advanced Features

  • Returning User Fast Path: Automatically resumes audits by pulling stored goals from USER.md.
  • Duplication Taxonomy: Categorizes redundancies into Pure Waste, Contextual Reinforcement, or Drift-Prone Duplication.
  • Token Efficiency Assessment: Calculates the approximate cost of 'bloat' beliefs to optimize the agent's context window.
  • Staging Safety: Writes all revised files to a protected output directory to prevent accidental overwriting of production configs.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*