romanescu11/hermes-skill-factory

# GitHub Repository: Romanescu11/hermes-skill-factory

**URL:** https://github.com/Romanescu11/hermes-skill-factory
**Author:** Romanescu11
**Description:**  A meta-skill plugin for Nous Research's Hermes AI agent that watches your workflows and automatically turns them into reusable skills.  Every time you work with Hermes and solve something — setting up a project, debugging code, creating a PR — that   workflow disappears at the end of the session. You have to explain it again next time.
**Homepage:** 
**Language:** Python

## Stats
- Stars: 391
- Forks: 51
- Open Issues: 5
- Commits: 1
- Created: 2026-03-18T12:28:01Z
- Updated: 2026-06-18T16:22:37Z
- Pushed: 2026-03-18T13:13:38Z

## README
# 🏭 Skill Factory

> **The meta-skill that creates skills.**
> Your AI watches your workflows and turns them into reusable Hermes skills — automatically.

Built for [Nous Research's Hermes Agent](https://github.com/NousResearch/hermes-agent) (v2026.3+).

---

## What It Does

Every time you solve a problem with Hermes, you're performing a workflow worth repeating. Skill Factory watches silently, detects patterns, and at the right moment asks:

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏭 SKILL FACTORY — New Skill Detected
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

I noticed you repeatedly set up a Python environment,
installed dependencies, and ran tests in the same order.

Proposed Skill:   python-env-setup
Category:         software-development
Description:      Reproducible Python project setup workflow

What it captures:
  1. Create venv and activate
  2. Upgrade pip and install dependencies
  3. Run pytest to verify environment

Generate: [A] SKILL.md  [B] plugin.py  [C] Both  [D] Skip
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

Say **C** and it writes both files immediately:

- `~/.hermes/skills/<category>/<name>/SKILL.md` — AI instructions for the workflow
- `~/.hermes/plugins/<name>.py` — A slash command that triggers it directly

---

## Installation

**Requirements:** Hermes Agent v2026.3+

```bash
git clone https://github.com/your-username/hermes-skill-factory
cd hermes-skill-factory
bash install.sh
```

Or manually:

```bash
# Install the meta-skill
mkdir -p ~/.hermes/skills/meta/skill-factory
cp skills/skill-factory/SKILL.md ~/.hermes/skills/meta/skill-factory/

# Install the plugin
cp plugins/skill_factory.py ~/.hermes/plugins/
```

Then activate:

```bash
hermes skills reload
hermes skills enable skill-factory
```

---

## Usage

Once installed, Skill Factory runs in the background during every session.

| Command | What it does |
|---|---|
| `/skill-factory propose` | Analyze the session and propose the top detected skill now |
| `/skill-factory list` | List all skills generated this session |
| `/skill-factory status` | Show how many patterns are being tracked |
| `/skill-factory queue` | Show all detected patterns queued for proposal |
| `/skill-factory save <name>` | Save the last proposal with a custom name |
| `/skill-factory clear` | Clear the current session log |

**Tip:** You can also just tell Hermes naturally:
- *"Save this as a skill"*
- *"Remember how to do this"*
- *"Turn this workflow into a reusable skill"*

---

## What Gets Generated

### SKILL.md

A complete skill definition following Hermes' native skill format:

```markdown
---
name: Python Env Setup
category: software-development
description: Reproducible Python project setup
tags: [python, venv, testing]
---

# Python Env Setup

## When to Activate
...

## Workflow
### Phase 1: Environment
1. python -m venv .venv
2. source .venv/bin/activate
...

## Examples
...
```

### plugin.py

A scaffolded Hermes plugin with a slash command:

```python
def register(hermes):
    @hermes.command(name="python-env-setup", ...)
    async def run_skill(ctx, args=""):
        # Step 1: Create venv
        # Step 2: Install deps
        # Step 3: Run tests
        ...
```

---

## Repo Structure

```
hermes-skill-factory/
├── skills/
│   └── skill-factory/
│       └── SKILL.md          # The meta-skill (core AI instructions)
├── plugins/
│   └── skill_factory.py      # Plugin: /skill-factory commands
├── templates/
│   ├── SKILL_TEMPLATE.md     # Template for generated skills
│   └── PLUGIN_TEMPLATE.py    # Template for generated plugins
├── examples/
│   └── generated/
│       └── git-pr-workflow/  # Example of a Skill Factory output
│           └── SKILL.md
├── docs/
│   └── how-it-works.md       # Architecture deep-dive
└── install.sh                # One-command installer
```

---

## How It Works

See [docs/how-it-works.md](docs/how-it-works.md) for a full breakdown.

**TL;DR:**
1. `SKILL.md` teaches the Hermes AI *how* to observe, detect, and propose skills
2. `skill_factory.py` provides the `/skill-factory` commands and file generation
3. You work normally — Skill Factory watches silently and proposes at the right moment

---

## Examples

The `examples/generated/` directory contains real example outputs from Skill Factory:

- [`git-pr-workflow`](examples/generated/git-pr-workflow/SKILL.md) — End-to-end PR creation workflow

---

## Contributing

PRs welcome. If you've generated a great skill using Skill Factory, consider adding it to `examples/generated/` with a PR.

---

## License

MIT