Skip to content

Repository files navigation

🧰 Essential Hermes Skills — The Power Bundle

Five production-tested skills that turn Hermes Agent into a serious workhorse.
Run any complex project. Open up any program. Debug any codebase. Search the web. Read any page.
Built from real debugging sessions. Battle-tested in production.

5 Production Skills Hermes Agent Cross-Platform Essential Workflows License MIT

by Ringo / MilkyWay008 · MIT License


📑 Table of Contents


💡 What This Bundle Is

A curated collection of five essential Hermes Agent skills — the kind of tools you reach for every single day:

  • Execute complex multi-phase projects without losing the thread
  • Reverse — open up any program, find out why it breaks, and check whether it's safe
  • Debug unfamiliar codebases with discipline, not chaos
  • Search the web with a tiered fallback chain that never dead-ends
  • Extract content from any page — even JavaScript-heavy SPAs

Each skill is self-contained, production-tested, and documented with its own README. Drop any of them into any Hermes profile and it just works.

The philosophy: skills should be enforced systems, not suggestions. Every skill here encodes hard rules, triggers, and fallbacks — so the agent does the right thing without being reminded.


📦 The Five Skills

1. 🏗️ complex-project-workflow — The Master Project Engine

What it is: A universal 7-phase master workflow — Charter → Recon → Blueprint → Review → Execute → Assemble → Retrospect — for any complex project: code builds, consulting, content, research, or multi-phase delivery.

Why it's useful:

  • One workflow for everything — builds, consulting, content creation, business ops, research
  • Hard gates between phases — you can't execute before the blueprint is reviewed
  • Duck-council audits — multiple LLM perspectives before critical decisions
  • Orchestrator discipline — the agent never implements directly; it plans, delegates, and verifies
  • Context-health first — subagents absorb the heavy lifting so the main thread stays sharp
  • Expanded Mode for client/non-code work, time-boxed event prep built in

Trigger phrases: "MASTER WORKFLOW — use for ANY project" · 2+ phases · 3+ components · external stakeholders


2. 🕵️ reverse-skill — Open Up Any Program and See What's Inside

What it is: software is a black box — you see what it shows you, not what it does. When a program breaks, won't start, acts suspicious, or hides its logic, this 85-skill pack (ported from the popular reverse-skill project, 24.4k⭐) gives your agent the tools to open the box: read the code inside apps, find out why they crash, and judge whether they're safe.

Everyday examples:

  • "This app won't open anymore." A program (say, QuickBooks) crashes on launch and the error says nothing useful. reverse-skill inspects the compiled code, finds what broke, and tells you exactly why.
  • "Is this downloaded file safe?" You grabbed something from a sketchy site. The malware-analysis module dissects it — what it does, where it phones home — without running it on your machine.

Why coders and IT pros need it: troubleshooting closed-source software, security audits, and working with legacy code you don't have the source for.

Trigger phrases: "this app won't open" · "is this file safe" · "analyze this APK" · "why is this app calling home" — any troubleshooting / security-audit / RE task


3. 🔧 app-debug-workflow — Disciplined Codebase Auditing

What it is: A 90-minute timeboxed, multi-session workflow for auditing an unfamiliar full-stack codebase — security, performance, reliability, and dev-tooling bugs.

Why it's useful:

  • Timeboxed by design — 90 minutes, no rabbit holes, no scope creep
  • Session discipline — Session A (debug, no code) then Session B (fix, no planning): you never break what you're analyzing
  • Multi-verifier gates — rubber-duck and subagent audits before anything gets fixed
  • Complete pipeline — discover → duck-verify → plan → handoff → fix → validate
  • 25 documented pitfalls — MSYS2 path bugs, venv isolation, patch backslashes, taskkill git-bash traps — learned the hard way, so you don't have to

Trigger phrases: "codebase audit" · "security review" · "bug hunt" · "audit this unfamiliar codebase for bugs"


4. 🔎 web_search — Tiered Search That Never Fails

What it is: A tiered web-search chain — DeepSeek → Tavily → TinyFish → DuckDuckGo — that replaces the built-in web_search tool with a richer, key-managed chain.

Why it's useful:

  • Best answer first — DeepSeek sits at tier 1 because deepseek-v4-flash (0731 build) natively supports the Responses API protocol, which includes native server-side search: the model searches the web itself and synthesizes an actual answer in one call — no separate search round-trip, no raw link list to post-process
  • Raw results when you need them — Tavily/TinyFish/DuckDuckGo for links, citations, and sources (effectively free)
  • Fail-fast fallthrough — auto mode tries tier 1 → 2 → 3 → 4 and stops at the first success
  • Zero-key safety net — DuckDuckGo needs no key, so the chain always has a last resort
  • Standalone by design — scripts only need Python 3 stdlib; drop the folder into any profile or publish to GitHub as-is
  • SOUL.md injection — teach the agent to prefer this skill over the built-in tool, automatically

Trigger phrases: any web search / online lookup / fact-check / research — "Search for X" · "Look up Y" · "Find information about Z"


5. 🌐 web_extract — Read Any Page, No Matter What

What it is: A tiered web-content extraction skill — Jina Reader first (except X.com), trafilatura fallback (best for X.com), headless browser as last resort.

Why it's useful:

  • Never dead-ends — three fallback tiers mean almost any URL is readable: articles, docs, JS-heavy SPAs, X.com posts
  • Cost-aware — free tiers first, expensive browser automation last
  • Verbatim code — every method ships with copy-paste commands (curl, execute_code, browser_navigate)
  • Known-limitations table — YouTube 403s, login-gated pages, 429/451/403, the 50KB stdout cap — documented up front

Trigger phrases: user gives a URL and asks to read, extract, fetch, summarize, or look up its content


🧭 Which Skill Do I Use When?

Situation Skill
"Run this complex project end-to-end" 🏗️ complex-project-workflow
"This app won't open / is this file safe / why is it calling home" 🕵️ reverse-skill
"Audit this unfamiliar codebase for bugs" 🔧 app-debug-workflow
"Search for / look up / find out X" 🔎 web_search
"Read / summarize this URL" 🌐 web_extract
Research project needing both search + extraction 🔎 web_search → 🌐 web_extract
Project with a research phase 🏗️ complex-project-workflow (Recon phase)
A code project that also involves closed-source or suspicious binaries 🏗️ complex-project-workflow → 🕵️ reverse-skill

⚙️ How They Work Together

              ┌─────────────────────────────────┐
              │  complex-project-workflow       │
              │  (the master engine)            │
              │  Charter → Recon → Blueprint →  │
              │  Review → Execute → Assemble →  │
              │  Retrospect                     │
              └──────┬──────────────┬───────────┘
                     │              │
        Recon/Research phase   Execute phase
                     │              │
        ┌────────────▼───┐    ┌─────▼────────────┐
        │  web_search    │    │ app-debug-workflow│
        │  (find info)   │    │ (fix the code)    │
        └────────┬───────┘    └─────┬────────────┘
                 │                  │
        ┌────────▼────────┐   ┌─────▼─────────────┐
        │  web_extract    │   │  reverse-skill    │
        │  (read it fully)│   │ (open any program)│
        └─────────────────┘   └───────────────────┘
  • complex-project-workflow is the orchestrator — it knows when each phase runs
  • web_search + web_extract power the research phases (find → read)
  • app-debug-workflow powers the execute phase when the project is a code audit/fix
  • reverse-skill is the "what is this thing really doing?" specialist — when the project hits a closed-source binary, a suspicious file, a crashing app, or a security audit, it opens the black box; it also feeds findings back into complex-project-workflow's research phase
  • All five share one principle: hard rules, enforced systems, no drift

🚀 Quick Start

Install

Each skill is a self-contained folder. Copy the skill folder you want into your Hermes profile's skills directory (~/.hermes/skills/ or your profile's skills dir):

# generic — works for any Hermes profile
cp -r complex-project-workflow ~/.hermes/skills/software-development/
cp -r app-debug-workflow ~/.hermes/skills/software-development/
cp -r web_search ~/.hermes/skills/web/
cp -r web_extract ~/.hermes/skills/web/

# reverse-skill — Option A: whole pack as one folder (recommended)
cp -r reverse-skill/skills ~/.hermes/skills/reverse-skill/            # router + 40 modules + 41 CTF sub-skills + master, all in one folder

Configure

Skill Setup required
complex-project-workflow None — works out of the box
reverse-skill None — works out of the box (tools auto-bootstrap on demand; optional MCP integrations are additive)
app-debug-workflow None — works out of the box
web_search API keys in profile .env (DEEPSEEK_API_KEY, TAVILY_API_KEY, TINYFISH_API_KEY) + optional pip install duckduckgo-search
web_extract pip install trafilatura (optional but recommended)

Verify

Trigger each skill with its phrase — e.g. ask the agent to "run this as a master workflow" (complex-project-workflow), "this app won't open" (reverse-skill), "audit this codebase" (app-debug-workflow), "search for X" (web_search), or "read this URL" (web_extract).


📁 Repository Structure

essential-hermes-skills/
├── README.md                    ← this file (bundle overview)
├── LICENSE                      ← MIT
├── complex-project-workflow/    ← 7-phase master project engine
│   ├── SKILL.md
│   ├── README.md
│   └── references/
├── reverse-skill/               ← 85-skill "open up any program" pack (Hermes port)
│   ├── README.md                ← Hermes guide (front page) + language note
│   ├── README-hermes.md         ← Hermes guide (duplicate, kept for visibility)
│   ├── README-orignal.md        ← upstream README (preserved)
│   ├── LICENSE                  ← upstream MIT (zhaoxuya520)
│   ├── skills/                  ← router + 40 specialist modules + CTF + scripts
│   │   ├── SKILL.md             ← reverse-skill-router (pack entry point)
│   │   ├── <module>/            ← 40 RE/security modules (apk-reverse, ida-reverse, …)
│   │   ├── CTF-Sandbox-Orchestrator/ ← 41 CTF competition sub-skills + master orchestrator
│   │   ├── scripts/             ← bootstrap + case-init tooling
│   │   └── field-journal/       ← self-evolving lessons
│   └── kali/                    ← Kali Linux edition docs
├── app-debug-workflow/          ← 90-min disciplined codebase auditing
│   ├── SKILL.md
│   ├── README.md
│   └── references/
├── web_search/                  ← tiered search (deepseek → tavily → tinyfish → ddgs)
│   ├── SKILL.md
│   ├── README.md
│   └── scripts/
│       ├── search.py            ← dispatcher (auto tier chain)
│       ├── deepseek_search.py   ← tier 1: DeepSeek /responses web_search
│       ├── tavily_search.py     ← tier 2: Tavily API
│       ├── tinyfish_search.py   ← tier 3: TinyFish API
│       └── ddgs_search.py       ← tier 4: DuckDuckGo (no key)
└── web_extract/                 ← tiered web-content extraction
    ├── SKILL.md
    └── README.md

🔍 Search Keywords

Essential Hermes Skills · Hermes skills bundle · Hermes Agent skills · complex project workflow · master workflow agent · reverse-skill Hermes · reverse engineering skills · APK reverse Hermes · malware analysis skill · security skills Hermes · pentest skills agent · codebase audit skill · debug workflow agent · web search skill · tiered web search · web extraction skill · read any URL agent · Hermes agent skills pack · AI agent workflows · agentic debugging · production Hermes skills · Hermes skill collection · multi-phase project agent · duck-council audit


📝 License

MIT — free to use, modify, and distribute. See LICENSE.

Mixed licensing: the pack's CTF-Sandbox-Orchestrator/ subtree ships under GNU GPL v3 (its own preserved LICENSE) — respect GPLv3 terms when redistributing that subtree. See reverse-skill/README.md → Attribution & license for details.


Essential Hermes Skills — run it, open it, debug it, search it, read it. Every day.
Hard rules. Enforced systems. No drift. 🧰

About

Essential Hermes Agent skills — battle-tested workflows: app-debug-workflow, complex-project-workflow, web_search, web_extract.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages