← Back to Skills Marketplace
kkkkhazix

Neat Freak

by Khazix · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
171
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install neat-freak
Description
End-of-session knowledge cleanup with OCD-level rigor — reconciles project docs (CLAUDE.md, README.md, docs/) and agent memory against the code so nothing ro...
Usage Guidance
Plain-language checklist before installing/using: - Understand what this skill will do: it will scan and may edit your repository docs and agent memory files (including per-user files under your home dir such as ~/.claude, ~/.codex, ~/.openclaw) unless you restrict it. This is consistent with its purpose but grants broad local file access. - Metadata mismatch: the skill metadata declares no config paths, yet SKILL.md directs reads/writes to home-dir agent files. Ask the publisher why config access was omitted from the metadata and request explicit declaration of the paths the skill will touch. - Prefer safety controls: only run the skill in a sandboxed workspace or on a branch. Ensure your repo is under version control and create a backup or branch before allowing automatic edits. - Require manual review: configure the agent (or your workflow) so file changes are proposed as diffs/PRs rather than committed directly. The SKILL.md requires actual edits — make those edits visible to you before they are finalized. - Limit scope: if possible, instruct the agent to operate only within the current project directory and to never write global agent files (~/.claude, ~/.codex, ~/.openclaw) unless you explicitly ask for cross-project sync. - Watch for secrets: docs and memory files can reference environment variables or credentials. Review any changes that add or expose such references. - If you need higher assurance: request the skill author add declared config paths and an explicit confirmation step in SKILL.md, or run the skill locally with an agent instance whose permissions are limited. Overall: the behavior aligns with its goal but the missing metadata declaration and the potential to edit global agent files make this suspicious rather than clearly benign. Proceed only after enforcing backups, PR-based reviews, and scope limits.
Capability Analysis
Type: OpenClaw Skill Name: neat-freak Version: 1.0.2 The 'neat-freak' skill is designed to synchronize project documentation and agent memory, but it requires high-risk permissions to function. Specifically, SKILL.md and references/agent-paths.md instruct the agent to read, modify, and delete files within sensitive internal directories such as ~/.claude/ and ~/.openclaw/. While these actions are aligned with the stated purpose of 'knowledge cleanup,' the broad file system access and the explicit instruction to delete 'obsolete' files represent a significant risk for unintended data loss or unauthorized access to private agent state across multiple platforms.
Capability Assessment
Purpose & Capability
The skill's stated purpose is to reconcile project docs and agent memory, which reasonably requires reading and editing repository files and any per-agent memory. However the package metadata declares no required config paths or credentials while the SKILL.md explicitly instructs the agent to read/write user home paths (e.g. ~/.claude/projects/.../memory/, ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md, ~/.openclaw/skills/). That mismatch (metadata says no config access, runtime instructions require it) is an incoherence.
Instruction Scope
The SKILL.md explicitly instructs the agent to run filesystem commands (ls, find, grep) and to perform edits, creates, and deletions across project docs and agent memory. Those actions are consistent with the described purpose, but they give the agent broad read/write access to both project and potential global agent configuration files. The skill does not constrain or explicitly require user confirmation before making file changes.
Install Mechanism
Instruction-only skill with no install spec and no code files — lowest install risk. Nothing is downloaded or installed by the skill itself.
Credentials
The skill requests no environment variables or credentials in metadata. However the runtime instructions direct the agent to read files (project docs, memory files, and possibly files that list environment variables). Reading these files may expose environment-related secrets indirectly; the SKILL.md does not declare or limit that access.
Persistence & Privilege
The skill is not always-enabled and is user-invocable (good). But it instructs the agent to modify persistent artifacts including project docs and agent-global files (~/.claude, ~/.codex, ~/.openclaw). That capability can change cross-project agent state. Because metadata did not declare config paths and there's no install-time gating, this is a privilege that should be explicitly acknowledged and limited by the user.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install neat-freak
  3. After installation, invoke the skill by name or use /neat-freak
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Fix Codex skills path: ~/.agents/skills/ → ~/.codex/skills/
v1.0.1
Add /neat as an explicit trigger word
v1.0.0
Initial public release
Metadata
Slug neat-freak
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Neat Freak?

End-of-session knowledge cleanup with OCD-level rigor — reconciles project docs (CLAUDE.md, README.md, docs/) and agent memory against the code so nothing ro... It is an AI Agent Skill for Claude Code / OpenClaw, with 171 downloads so far.

How do I install Neat Freak?

Run "/install neat-freak" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Neat Freak free?

Yes, Neat Freak is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Neat Freak support?

Neat Freak is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Neat Freak?

It is built and maintained by Khazix (@kkkkhazix); the current version is v1.0.2.

💬 Comments