Skip to content
Back to search

hermes-skill-factory

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/romanescu11--hermes-skill-factory/badge.svg)](/listings/romanescu11--hermes-skill-factory)

HTML

<a href="/listings/romanescu11--hermes-skill-factory"><img src="/api/listings/romanescu11--hermes-skill-factory/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

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

Or manually:

# 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:

hermes skills reload
hermes skills enable skill-factory

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 187 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🏭 Skill Factory
  2. > **The meta-skill that creates skills.**
  3. > Your AI watches your workflows and turns them into reusable Hermes skills — automatically.
  4. Built for [Nous Research's Hermes Agent](https://github.com/NousResearch/hermes-agent) (v2026.3+).
  5. ---
  6. ## What It Does
  7. 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:
  8. ```
  9. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  10. 🏭 SKILL FACTORY — New Skill Detected
  11. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  12. I noticed you repeatedly set up a Python environment,
  13. installed dependencies, and ran tests in the same order.
  14. Proposed Skill: python-env-setup
  15. Category: software-development
  16. Description: Reproducible Python project setup workflow
  17. What it captures:
  18. 1. Create venv and activate
  19. 2. Upgrade pip and install dependencies
  20. 3. Run pytest to verify environment
  21. Generate: [A] SKILL.md [B] plugin.py [C] Both [D] Skip
  22. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  23. ```
  24. Say **C** and it writes both files immediately:
  25. - `~/.hermes/skills/<category>/<name>/SKILL.md` — AI instructions for the workflow
  26. - `~/.hermes/plugins/<name>.py` — A slash command that triggers it directly
  27. ---
  28. ## Installation
  29. **Requirements:** Hermes Agent v2026.3+
  30. ```bash
  31. git clone https://github.com/your-username/hermes-skill-factory
  32. cd hermes-skill-factory
  33. bash install.sh
  34. ```
  35. Or manually:
  36. ```bash
  37. # Install the meta-skill
  38. mkdir -p ~/.hermes/skills/meta/skill-factory
  39. cp skills/skill-factory/SKILL.md ~/.hermes/skills/meta/skill-factory/
  40. # Install the plugin
  41. cp plugins/skill_factory.py ~/.hermes/plugins/
  42. ```
  43. Then activate:
  44. ```bash
  45. hermes skills reload
  46. hermes skills enable skill-factory
  47. ```
  48. ---
  49. ## Usage
  50. Once installed, Skill Factory runs in the background during every session.
  51. | Command | What it does |
  52. |---|---|
  53. | `/skill-factory propose` | Analyze the session and propose the top detected skill now |
  54. | `/skill-factory list` | List all skills generated this session |
  55. | `/skill-factory status` | Show how many patterns are being tracked |
  56. | `/skill-factory queue` | Show all detected patterns queued for proposal |
  57. | `/skill-factory save <name>` | Save the last proposal with a custom name |
  58. | `/skill-factory clear` | Clear the current session log |
  59. **Tip:** You can also just tell Hermes naturally:
  60. - *"Save this as a skill"*
  61. - *"Remember how to do this"*
  62. - *"Turn this workflow into a reusable skill"*
  63. ---
  64. ## What Gets Generated
  65. ### SKILL.md
  66. A complete skill definition following Hermes' native skill format:
  67. ```markdown
  68. ---
  69. name: Python Env Setup
  70. category: software-development
  71. description: Reproducible Python project setup
  72. tags: [python, venv, testing]
  73. ---
  74. # Python Env Setup
  75. ## When to Activate
  76. ...
  77. ## Workflow
  78. ### Phase 1: Environment
  79. 1. python -m venv .venv
  80. 2. source .venv/bin/activate
  81. ...
  82. ## Examples
  83. ...
  84. ```
  85. ### plugin.py
  86. A scaffolded Hermes plugin with a slash command:
  87. ```python
  88. def register(hermes):
  89. @hermes.command(name="python-env-setup", ...)
  90. async def run_skill(ctx, args=""):
  91. # Step 1: Create venv
  92. # Step 2: Install deps
  93. # Step 3: Run tests
  94. ...
  95. ```
  96. ---
  97. ## Repo Structure
  98. ```
  99. hermes-skill-factory/
  100. ├── skills/
  101. │ └── skill-factory/
  102. │ └── SKILL.md # The meta-skill (core AI instructions)
  103. ├── plugins/
  104. │ └── skill_factory.py # Plugin: /skill-factory commands
  105. ├── templates/
  106. │ ├── SKILL_TEMPLATE.md # Template for generated skills
  107. │ └── PLUGIN_TEMPLATE.py # Template for generated plugins
  108. ├── examples/
  109. │ └── generated/
  110. │ └── git-pr-workflow/ # Example of a Skill Factory output
  111. │ └── SKILL.md
  112. ├── docs/
  113. │ └── how-it-works.md # Architecture deep-dive
  114. └── install.sh # One-command installer
  115. ```
  116. ---
  117. ## How It Works
  118. See [docs/how-it-works.md](docs/how-it-works.md) for a full breakdown.
  119. **TL;DR:**
  120. 1. `SKILL.md` teaches the Hermes AI *how* to observe, detect, and propose skills
  121. 2. `skill_factory.py` provides the `/skill-factory` commands and file generation
  122. 3. You work normally — Skill Factory watches silently and proposes at the right moment
  123. ---
  124. ## Examples
  125. The `examples/generated/` directory contains real example outputs from Skill Factory:
  126. - [`git-pr-workflow`](examples/generated/git-pr-workflow/SKILL.md) — End-to-end PR creation workflow
  127. ---
  128. ## Contributing
  129. PRs welcome. If you've generated a great skill using Skill Factory, consider adding it to `examples/generated/` with a PR.
  130. ---
  131. ## License
  132. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.