iruzen-dono

Hermes Project Oracle — Development skill for Claude Code

Development community

Deep project scanner for Hermes Agent — generates AGENTS.md, CLAUDE.md, and Obsidian vault notes.

How to install Hermes Project Oracle

This entry records only its repository, not the path inside it, so there is no exact command to give. Open iruzen-dono/hermes-project-oracle and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hermes Project Oracle does

Deep project scanner for Hermes Agent — generates AGENTS.md, CLAUDE.md, and Obsidian vault notes.

Alternatives in Development

Obsidian MCP Server — Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP 686 ★
Obsidian Decide — Extract decisions from this conversation and log them to the right project notes 277 ★
Obsidian MCP Connector — Your Obsidian vault, exposed to Claude, Codex, Cursor and any MCP client 115 ★

README

Hermes Project Oracle 🧠

**Deep project scanner for [Hermes Agent](https://hermes-agent.nousresearch.com).** Scan any codebase and generate AGENTS.md, CLAUDE.md, or Obsidian vault notes so your agent understands the project instantly.

Features

28 languages detected — Python, Java, Kotlin, TypeScript, Go, Rust, PHP, C#, Ruby, and more
Framework auto-detection — Spring Boot, Next.js, Laravel, Django, FastAPI, React Native, Flutter
Build system detection — Maven, Gradle, npm/yarn/pnpm, uv/pip, Cargo, Go modules, Composer
Convention detection — ESLint, Prettier, Ruff, Black, Checkstyle, EditorConfig, commit style, CI/CD
Multi-template output — AGENTS.md, CLAUDE.md, Obsidian vault notes, or all in one pass
Cross-platform — Windows, Linux, macOS (pathlib everywhere, no platform-specific code)
Zero dependencies — pure Python 3.11+ stdlib

Quick Start

# Clone the repo
git clone https://github.com/iruzen-dono/hermes-project-oracle.git

# Copy to your Hermes skills
cp -r hermes-project-oracle ~/.hermes/skills/hermes-project-oracle

# Scan a project
python ~/.hermes/skills/hermes-project-oracle/scripts/oracle_scan.py \
  --path /path/to/your/project \
  --output .oracle/

# Generate AGENTS.md
python ~/.hermes/skills/hermes-project-oracle/scripts/oracle_generate.py \
  --scan .oracle/scan-report.json \
  --template agents-md \
  --output /path/to/your/project/AGENTS.md

Scripts

Script	Purpose
`scripts/oracle_scan.py`	Deep project scan → JSON report (288 file extensions, AST-informed)
`scripts/oracle_generate.py`	Report → context files (4 templates: agents-md, claude-md, obsidian, full)
`scripts/oracle_vault.py`	Push a structured note into Obsidian vault