Hermes Droid

A standalone Agent Skill for delegating coding work to Factory Droid through its droid CLI.

Why Install This Skill

Use it when an AI agent needs to choose, invoke, and safely supervise Factory Droid for code analysis, bounded edits, specification-first implementation, or larger multi-agent missions.

What You Get

  • A compact operational guide for droid exec
  • Deliberate autonomy guidance, including worktree isolation
  • Focused references for authentication, missions, model selection, and agent comparison
  • No runtime dependency or wrapper: the bundle documents the upstream droid CLI

Quick Start

  1. Install and authenticate Factory Droid: 
    curl -fsSL https://app.factory.ai/cli | sh
droid
  2. Copy or symlink factory-droid/ into your agent's skill directory.
  3. Let the agent load factory-droid/SKILL.md when you ask it to use Factory Droid.
  4. Verify the installation: 
    droid exec -o json --auto low "Respond with: OK"

Triggers

Use this bundle for requests such as:

  • "Use Factory Droid to implement this feature."
  • "Run a spec-first coding task with droid."
  • "Use droid in an isolated worktree."
  • "Delegate this larger refactor to Factory."

It is not a Factory CLI replacement and does not install, authenticate, or operate droid on its own.

Requirements

  • macOS or Linux
  • Factory's droid CLI installed and authenticated
  • A Git repository for coding tasks, especially tasks that write files

Repository Layout

factory-droid/          # Portable Agent Skill bundle
  SKILL.md              # Agent instructions and trigger metadata
  references/           # Load-on-demand operational detail
AGENTS.md               # Instructions for agents changing this repository
CONTRIBUTING.md         # Human contribution workflow
scripts/validate.py     # Dependency-free structural validation

Provenance

This repository extracts the standalone factory-droid skill originally proposed in NousResearch/hermes-agent#43347, at source commit cf84ebfc7ad4ebb3ac72cc6f70685a08f36e21fb. It is maintained independently so it can be installed and improved without waiting for that upstream PR.

Contributing

Read CONTRIBUTING.md, then run:

python3 scripts/validate.py

Released under the MIT License.