hermes-project-oracle

hermes-project-oracle is a skill for Claude Code, Codex from iruzen-dono/hermes-project-oracle. It costs 18 tokens per session (916 once invoked), scanned A, original, MIT.

A project-analysis tool that examines a codebase and creates context files such as AGENTS.md, CLAUDE.md, or an Obsidian note. These files describe the project's structure, technologies, conventions, and API routes for coding agents.

In plain words
What is it for?
Use it when starting work on a project, changing projects, or documenting its architecture. It can scan the project and generate the selected context-file format.
Why use it?
It reduces the time spent explaining an unfamiliar project to an agent and helps preserve conventions that may not be obvious from the code alone.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions CLAUDE.md; mentions AGENTS.md.

Good fit Use it when starting work on a project, changing projects, or documenting its architecture. It can scan the project and generate the selected context-file format.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/iruzen-dono/hermes-project-oracle/hermes-project-oracle
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add iruzen-dono/hermes-project-oracle --skill hermes-project-oracle
Clone the repo
git clone --depth 1 https://github.com/iruzen-dono/hermes-project-oracle

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for hermes-project-oracle

README.md
[![agentmods](https://agentmods.dev/badge/skills/iruzen-dono/hermes-project-oracle/hermes-project-oracle/github.svg)](https://agentmods.dev/skills/iruzen-dono/hermes-project-oracle/hermes-project-oracle)
Your own site
<a href="https://agentmods.dev/skills/iruzen-dono/hermes-project-oracle/hermes-project-oracle"><img src="https://agentmods.dev/badge/skills/iruzen-dono/hermes-project-oracle/hermes-project-oracle/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for hermes-project-oracle

Your own site · 80×15
<a href="https://agentmods.dev/skills/iruzen-dono/hermes-project-oracle/hermes-project-oracle"><img src="https://agentmods.dev/badge/skills/iruzen-dono/hermes-project-oracle/hermes-project-oracle.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 18 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 916 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00018 $0.00916
Opus 5 $0.00009 $0.00458
Sonnet 5 $0.00004 $0.00183
Haiku 4.5 $0.00002 $0.00092

Measured 11d ago against content hash e7b9193ace77, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

hermes-project-oracle scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

SKILL.md · 97 lines

How it starts

The opening of the file, as written. The whole thing — 97 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Hermes Project Oracle Skill

Analyse en profondeur n'importe quel projet et génère des fichiers de contexte (AGENTS.md, CLAUDE.md, note Obsidian) pour qu'un agent comprenne instantanément l'architecture, les conventions et les points d'entrée.

When to Use

  • Première fois sur un projet — génère son AGENTS.md
  • Projet avec conventions implicites que les agents ne captent pas
  • Transition entre projets — switch de contexte propre
  • Documentation d'architecture dans Obsidian

Prerequisites

  • Python 3.11+
  • git (optionnel, pour le contexte git dans le scan)
  • Obsidian vault (optionnel, pour oracle_vault.py)

How to Run

Phase 1 — Scan

python <skill_dir>/scripts/oracle_scan.py --path <projet> --output .oracle/

Retourne un JSON structuré avec langage, framework, build system, arborescence, dépendances, conventions, routes API.

Phase 2 — Generate

python <skill_dir>/scripts/oracle_generate.py \
  --scan .oracle/scan-report.json \
  --output <projet>/AGENTS.md \
  --template agents-md

Templates disponibles : agents-md, claude-md, obsidian, full.

Phase 3 — Vault (optionnel)

python <skill_dir>/scripts/oracle_vault.py \
  --scan .oracle/scan-report.json

Quick Reference

Script Rôle Output
oracle_scan.py Scan complet du projet JSON structuré
oracle_generate.py Génération context files AGENTS.md / CLAUDE.md
oracle_vault.py Push note Obsidian Note dans vault

Procedure

  1. Demande à l'utilisateur de quoi parle le projet (le scan détecte la stack, pas l'intention)
  2. Scan avec oracle_scan.py --path <projet> --output .oracle/
  3. Analyse le rapport : entry points, structure données, flux, conventions, footguns
  4. Génère le fichier de contexte avec oracle_generate.py
  5. Valide : cat AGENTS.md | head -20 — le projet a-t-il l'air bien décrit ?
  6. Propose vault : "Tu veux que je pousse ça dans le vault aussi ?"

Read the full file on GitHub · 97 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 97 lines · 18 tokens per session scan A e7b9193ace77

Subscribe to this mod's changes

hermes-project-oracle is a skill published in the GitHub repository iruzen-dono/hermes-project-oracle (2 stars, last pushed 2mo ago), licensed MIT. It adds 18 tokens to every session and 916 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

agents-generator

Generate project-specific AGENTS.md and companion rules by analyzing a codebase. Supports full, minimal, update, and dry-run modes with package-manager detection, monorepos, backups, managed blocks, confidence scoring, and command validation.

sickn33/agentic-awesome-skills · 50 tokens

skill-sunset

Audit generic AGENTS.md, CLAUDE.md, and SKILL.md instructions for deterministic drift and model-era obsolescence candidates, then generate evidence-backed, reversible remediation prompts. Use when users ask to clean up, modernize, retire, or evaluate accumulated coding-agent instructions. Do not use it to…

ooocooc/open-skill-sunset · 73 tokens

steadyagent-workflow

Local-first Codex workflow for planning, debugging, reviewing, refactoring, improving AGENTS.md, building skills, publishing agent harness repositories, or running complex multi-step coding tasks that need staged diagnosis, context control, verification loops, review strategy, release evidence, and…

Khalilzhang0825/boring-is-all-you-need · 64 tokens

platform-specific-paths

Generic browser automation skill with Windows-only paths scanned from another operating system.

ooocooc/open-skill-sunset · 19 tokens

setup-rootloom

Plan, install, inspect, update, or roll back Rootloom Personal Core in a user's Codex home. Supports Skills-only, guidance, and the recommended personal preset. Use when the user explicitly asks for a Rootloom setup plan, installation, configuration, bootstrap, repair, audit, status, update, reduction, rollback, or…

qingye-lab/rootloom · 87 tokens

project-memory

Initialize, retrieve, and explicitly update the separate Rootloom Memory plugin's repository-owned architecture, risk, decision, and failure lessons. Use only when explicitly requested. Memory is experimental, advisory, and outside Rootloom Core.

qingye-lab/rootloom · 47 tokens