hermes-neat-freak: skill pack for Hermes Agent

Hermes skill for end-of-session cleanup that syncs docs, memory and reusable skills

What hermes-neat-freak does

The skill adapts the neat-freak idea of acting as an editor rather than a recorder to Hermes Agent's own knowledge mechanisms. It sorts what changed into stable facts for memory, reusable procedures for skill_manage, and past task history for session_search, and keeps AGENTS.md, README.md and website docs aligned. It enumerates project documents, reviews the current and related past sessions, corrects drift, and prints a short sync summary.

It adds Hermes-specific rules: the main skill directory is ~/.hermes/skills/, skills.external_dirs are best treated as read-only discovery sources, and high-risk external writes such as bulk database changes or live config edits must not be recorded as done without confirmation. Triggers include sync up, /neat and Chinese phrases such as 收尾一下. The repository holds SKILL.md plus references/agent-paths.md and references/sync-matrix.md, which map code changes to the docs, memory and skills that should follow.

Key features

Separates stable facts (memory), reusable procedures (skill_manage) and history (session_search)
Reviews AGENTS.md, README.md, docs and scattered markdown files for drift
Includes session_search in the wrap-up to reduce repeated explanations
Rule against marking high-risk external writes as done without confirmation
Reference files for agent paths and a code-change sync matrix

When to use it

Closing out a development, debugging or refactoring session
Keeping docs, memory and skills consistent after a platform integration
Cleaning up knowledge in long-running projects that span many sessions

Who it is for: Hermes users who maintain long-running projects and want their docs, memory and skills kept in sync.

How it fits with Hermes Agent

Built for Hermes Agent. It is designed around Hermes memory, skill_manage, session_search and AGENTS.md.

How to install hermes-neat-freak

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/chqchshj/hermes-neat-freak.git
mkdir -p ~/.hermes/skills/hermes-agent/
cp -r hermes-neat-freak ~/.hermes/skills/hermes-agent/

Note: Adapted from the original neat-freak skill, and the README is written in Chinese.

FAQ

What is hermes-neat-freak?

hermes-neat-freak is a Hermes Agent skill for end-of-phase cleanup. It reviews project docs, Hermes memory, skills and past sessions, then fixes drift between them and the current code.

How do I install hermes-neat-freak?

Clone the repository, create ~/.hermes/skills/hermes-agent/ and copy the hermes-neat-freak folder into it. You can then load it with /hermes-neat-freak or trigger it in plain language.

When should I run hermes-neat-freak?

Run it after a round of development, debugging, refactoring, doc cleanup or platform integration. Typical triggers are sync up, /neat and the Chinese phrase 收尾一下.