oh-my-hermes-agent: Building a Structured Workflow Layer for Hermes Agent

oh-my-hermes-agent (abbreviated as OMHM) is a native workflow skill package designed for Hermes Agent. It aims to enable chat-based AI assistants to maintain a natural conversation experience while possessing advanced capabilities such as routing decisions, task planning, evidence tracking, and code handover preparation, thereby handling complex tasks more reliably. The project is maintained by rlaope, and the source code is hosted on GitHub.

Hermes Agent is a chat-first AI agent framework, but as task complexity increases, the pure conversation mode struggles to ensure execution reliability and traceability. The design goal of OMHM is to add a deterministic local contract layer without changing Hermes' core architecture, converting users' ordinary messages into clear actions (such as answering, clarifying, researching, planning, delegating coding, or reporting status).

OMHM follows four design principles: 1. Natural language first: Users do not need to learn command syntax; the system automatically analyzes intentions. 2. Hermes native boundary: Non-intrusive integration, no need to modify Hermes core or run hidden services. 3. Delegation-first coding: Generate structured handover documents for external executors for coding requests to ensure code safety and reliability. 4. Evidence-aware state management: Refined state differentiation (e.g., preparing, executed, reviewed, etc.) to improve traceability.

OMHM provides a complete workflow toolset: 1. Hermes skill interface: Compliant skill packages can be directly integrated. 2. Guided installation: Install skills and optional plugins via the omh setup command. 3. Skill directory and routing: Intelligently distribute requests based on metadata. 4. Scenario-based script system: Predefined workflow paths for research, planning, etc. 5. Quality assurance and evidence ladder: Record execution evidence at each stage to prevent overcommitment. 6. Planning artifacts and code handover: Generate Markdown planning documents and coding task handover materials.

OMHM supports two installation methods: 1. Native skill installation: Directly install via the commands hermes skills tap add rlaope/oh-my-hermes-agent and hermes skills install oh-my-hermes. 2. Guided installation: Execute the installation script using curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes-agent/main/install.sh | sh, then run omh setup and omh doctor. When using, users only need to have a natural conversation with Hermes (e.g., "I want to safely add a repository feature"), and the system will automatically trigger the corresponding workflow.

OMHM is suitable for various scenarios: As a code review assistant in software development teams, it automatically analyzes PRs and provides feedback; researchers use it to organize notes and generate structured research plans; in daily office work, it helps break down complex tasks, track progress, and hand over to specialized tools.

OMHM supplements the Hermes ecosystem with a structured workflow layer, balancing natural conversation experience and complex task reliability. Its modular architecture, localized design, and standardized interfaces are technical highlights. In the future, the concept of combining natural conversation with structured workflows may become an important direction for AI assistant architecture, which is worth exploring by developers.