openclaw-md-improver

Audit CLAUDE.md, SOUL.md, and openclaw.json files across the OpenClaw workspace.

4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/oabdelmaksoud/Openclaw-skills-Compilations --skill openclaw-md-improver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-md-improver
Source: https://github.com/oabdelmaksoud/Openclaw-skills-Compilations/tree/main/openclaw-md-improver
Command: npx skills add https://github.com/oabdelmaksoud/Openclaw-skills-Compilations --skill openclaw-md-improver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit, evaluate, and improve CLAUDE.md, SOUL.md, and openclaw.json files across the OpenClaw workspace to ensure consistent project context and agent personality configuration.

Core Features & Use Cases

  • Discovery and assessment of documentation quality for CLAUDE.md, per-agent SOUL.md, and system openclaw.json.
  • Targeted updates with diffs and safe apply workflow after user approval.

Quick Start

Inspect and optimize OpenClaw workspace docs and config.

Frequently Asked Questions about openclaw-md-improver

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

FAQPage Schema
How do I audit CLAUDE.md and SOUL.md files for consistency?

To audit CLAUDE.md and SOUL.md files, parse their YAML frontmatter to evaluate documentation quality and workspace health. This generates a quality report identifying inconsistencies across shared root docs and per-agent personality files.

What is the best way to improve openclaw.json configuration health?

Improving openclaw.json health involves auditing system configuration files to ensure consistent project context. The audit proposes targeted updates with diffs and applies changes safely after user approval.

How does parsing YAML frontmatter work during a workspace health check?

Parsing YAML frontmatter during a workspace health check extracts metadata from CLAUDE.md and SOUL.md files to assess documentation consistency. This mechanism evaluates per-agent personality configurations and shared root docs.

Can I generate a quality report for multiple agent workspaces at once?

Yes, you can generate a quality report for multiple agent workspaces. The audit discovers and assesses CLAUDE.md, per-agent SOUL.md, and openclaw.json files across the entire OpenClaw workspace.

Does the documentation audit apply changes automatically without confirmation?

No, the documentation audit does not apply changes automatically. It proposes targeted updates with diffs and follows a safe apply workflow that requires explicit user approval before modifying any files.

Why do I need to audit per-agent SOUL.md files separately from root docs?

Auditing per-agent SOUL.md files separately from root docs ensures both shared project context and individual agent personality configurations are consistent. This targeted assessment improves overall workspace health.