Durable Files Weekly Review (Public)

Run a weekly token-optimization audit for durable instruction files in any OpenClaw workspace, generate a markdown report, and propose approval-gated cleanup...

Security Scan

The skill's code and instructions match its stated purpose: it locally scans specific durable files, generates a markdown report, and requires explicit approval before any deletions; there is no network I/O or secret access requested.

Purpose & Capability

Name/description, SKILL.md, and the included Python script are consistent: the script scans the listed durable files, estimates token counts, detects stale markers, and writes a report. The skill does not request unrelated credentials, binaries, or config paths.

Instruction Scope

Runtime instructions are narrowly scoped (run the included Python scanner on the workspace root and review its report). Note: the CLI accepts a --root argument, so whoever runs the tool can point it at any filesystem path; ensure the root parameter is set to the intended workspace to avoid scanning unrelated directories.

Install Mechanism

No install spec (instruction-only with a bundled script). Nothing is downloaded or executed from remote URLs. The script runs locally with standard Python and writes a markdown file to the specified output directory.

Credentials

No environment variables, credentials, or external endpoints are requested. The script only reads the specified filenames under the given root and writes a local report; this is proportionate to the stated purpose.

Persistence & Privilege

The skill does not request always:true and does not modify other skills or global agent settings. It writes only its own report file and does not perform deletions without explicit user approval as stated in SKILL.md.

Assessment

This skill appears coherent and limited in scope: it reads the listed durable files in whatever root you point it at, generates a markdown report, and requires explicit approval before edits. Before running: (1) confirm the --root argument points to the intended workspace (avoid running against system or home directories), (2) review the generated report before applying any cleanup, and (3) consider running the script in a sandbox or test workspace first. Note: the script has a minor implementation quirk in its regex patterns (double-escaped backslashes) that may reduce stale-marker detection accuracy — you may want to inspect or test the patterns if you rely on automated detection.

Durable Files Weekly Review (Sanitized / ClawHub)

Use this skill to audit durable instruction files and prepare cleanup proposals.

Default scope

Audit these files relative to a workspace root:

• AGENTS.md
• SOUL.md
• USER.md
• TOOLS.md
• MEMORY.md
• IDENTITY.md
• PRIORITIES.md
• SKILLS.md
• projects.md

Run

python3 scripts/durable_files_review_generic.py --root .

Optional:

python3 scripts/durable_files_review_generic.py --root /path/to/workspace --out knowledge/reports/durable-files

Workflow

1. Run scanner.
2. Open generated report.
3. Summarize top token-heavy files + stale markers.
4. Propose cleanup in batches.
5. Require explicit user approval before any deletions.
6. Apply approved edits and post concise changelog.

Success output

• Dated markdown report with metrics/findings
• Clear approval queue for removals
• No silent content removal