hermes-orama

Runs a single task through the Orama 5-stage pipeline via hermes_harness.py.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill hermes-orama-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-orama
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/hermes-harness/commands/hermes-orama
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill hermes-orama-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Running a complex task through a structured multi-stage methodology (context gathering, architecture, refinement, parallel execution and verification, crystallization) normally requires manual orchestration of each stage. This Skill executes the full Orama 5-stage pipeline against a single task in one foreground command. ## Core Features & Use Cases - Full 5-Stage Pipeline: Drives Context, Architect, Refiner, parallel Executor/Verifier, and Crystallizer stages through Perpetua-Tools hermes_harness.py using sequential AIAgent.chat calls. - Foreground Execution: Blocks until the complete run finishes and streams stage transitions plus the final crystallized result to the terminal. - Fail-Closed Launcher: Resolves the Perpetua-Tools harness path and exits with an error if it cannot be found, rather than failing silently. - Use Case: A developer needs a rate limiter designed and implemented with proper design review and verification, so they run one command that carries the task through all five methodology stages and returns a crystallized result. ## Quick Start Ask the AI to run hermes-orama with a task description such as "design and implement a rate limiter for the /health endpoint" and wait for the foreground pipeline to complete.

Frequently Asked Questions about hermes-orama

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a task through the full Orama 5-stage pipeline?

Invoke hermes-orama followed by your task description, for example "/hermes-orama design and implement a rate limiter". The launcher resolves hermes_harness.py and runs all five stages in the foreground until completion.

What is the difference between hermes-orama, hermes-spawn, and hermes-delegate?

hermes-orama runs one task through the full 5-stage pipeline in the foreground. hermes-spawn runs a task in a background non-blocking session, and hermes-delegate runs 2-5 independent tasks in parallel.

Does hermes-orama support JSON or structured output?

No, this wrapper prints human-readable output only: one status line plus whatever hermes_harness.py streams. For structured output, use hermes-delegate or parse the harness output directly.

Why does hermes-orama fail immediately when I run it?

It fails closed if the Perpetua-Tools hermes_harness.py path cannot be resolved, or if the task description is empty, in which case it prints a usage message. Check that Perpetua-Tools is installed and resolvable first.

When should I not use hermes-orama for a task?

Avoid it for quick questions that do not need staged methodology, and for long-running tasks that would block your session. Use a direct answer for simple tasks and hermes-spawn for long background runs.