Reusable skills and a dependency graph system for Hermes Agent.

3 skills you can drop into ~/.hermes/skills/ and use immediately, plus 3 tools that verify dependencies, visualize the skill graph, and suggest new skills from your session history.

Skills declare dependencies (tools, env vars, other skills) and define multi-step composition tests. The system verifies everything works end-to-end.

graph LR
    BWS_ACCESS_TOKEN([🔑 BWS_ACCESS_TOKEN]):::env --> bitwarden
    bws([⚙️ bws]):::tool --> bitwarden
    bitwarden[🔒 bitwarden]:::skill --> email-himalaya
    himalaya([⚙️ himalaya]):::tool --> email-himalaya
    himalaya-password([⚙️ himalaya-password]):::tool --> email-himalaya
    email-himalaya[📧 email-himalaya\ncomposition]:::comp

    classDef skill fill:#0f3460,stroke:#4a9eff,color:white
    classDef comp fill:#e94560,stroke:#ff6b6b,color:white
    classDef tool fill:#533483,stroke:#9b59b6,color:white
    classDef env fill:#1a1a2e,stroke:#ffcc00,color:#ffcc00

Composition test: BWS_ACCESS_TOKEN → bws secret list → password → himalaya envelope list → ✅

━━━ bitwarden ━━━
  ✅ tool: bws
  ✅ env: BWS_ACCESS_TOKEN
  ✅ verify: bws --version
  ✅ verify: bws secret list

━━━ email-himalaya ━━━
  ✅ tool: himalaya
  ✅ skill: bitwarden
  ✅ verify: himalaya --version
  composition: bws-to-himalaya-auth
  ✅   step1: password retrieval
  ✅   step2: himalaya connects to IMAP

━━━ PII scan ━━━
  ✅ bitwarden: clean
  ✅ email-himalaya: clean
  ✅ skill-autoresearch: clean

  RESULT: 18/18 passed, 0 failed

Analyzes your Hermes sessions and finds patterns:

Sessions analyzed: 14
CLI commands extracted: 125

━━━ CLI Tool Usage ━━━
   38x himalaya     ✅ covered by skill
   22x bws          ✅ covered by skill

━━━ Composition Candidates ━━━
  4x bws → himalaya  (already have email-himalaya skill)

When it finds tools you use frequently but have no skill for, it suggests creating one.

Add a dependencies block to your SKILL.md frontmatter:

---
name: my-skill
dependencies:
  tools: [docker, kubectl]
  env: [KUBECONFIG]
  skills: [cloud-auth]
  verify:
    - cmd: "kubectl cluster-info"
      expect: "running"
  compositions:
    - name: "deploy-flow"
      steps:
        - cmd: "docker build -t app . 2>&1 | tail -1"
          expect: "Successfully"
        - cmd: "kubectl apply -f deploy.yaml 2>&1"
          expect: "configured"
---

Then run skill-graph-test to verify everything works.

# Skills
cp -r bitwarden/ ~/.hermes/skills/bitwarden/
cp -r email-himalaya/ ~/.hermes/skills/email-himalaya/
cp -r skill-autoresearch/ ~/.hermes/skills/skill-autoresearch/

# Tools
install tools/skill-graph-test ~/.local/bin/
install tools/skill-graph-viz ~/.local/bin/
install tools/skill-graph-extract ~/.local/bin/

# Dependencies (for viz only)
pip install graphviz  # Python package
# Plus: graphviz system package (apt install graphviz / zypper install graphviz)

MIT