← 返回 Skills 市场
kkkkhazix

Neat Freak

作者 Khazix · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
171
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install neat-freak
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /neat-freak 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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
元数据
Slug neat-freak
版本 1.0.2
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 171 次。

如何安装 Neat Freak?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install neat-freak」即可一键安装,无需额外配置。

Neat Freak 是免费的吗?

是的,Neat Freak 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Neat Freak 支持哪些平台?

Neat Freak 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Neat Freak?

由 Khazix(@kkkkhazix)开发并维护,当前版本 v1.0.2。

💬 留言讨论