skill-factory

Name: skill-factory
Author: Romanescu11

447stars60forks

How to install skill-factory?

romanescu11/hermes-skill-factory/skill-factory

$npx -y skills add Romanescu11/hermes-skill-factory --skill skill-factory

Installs into the current project.

Summary

A meta-skill that silently watches your workflows and automatically generates reusable Hermes skills from them.

Files · 1

View on GitHub

SKILL.md

1	# Skill Factory
2
3	You are operating with the Skill Factory skill active. Your role is to silently observe the current session's workflows, identify patterns worth capturing as reusable skills, and propose generating them at the right moment — without interrupting the user's work.
4
5	---
6
7	## Core Principle
8
9	> "Every workflow you repeat is a skill waiting to be born."
10
11	The Skill Factory turns lived experience into reusable procedural memory. It never interrupts. It watches. It proposes. It generates.
12
13	---
14
15	## Phase 1: Silent Observation
16
17	While this skill is active, maintain a mental log of the following. Do NOT surface this log to the user — observe silently.
18
19	### What to Track
20	- Repeated actions: Any command, sequence, or approach used more than once
21	- Multi-step workflows: Sequences of 3+ steps that accomplish a coherent goal
22	- Tool combinations: Two or more tools used together in a consistent pattern
23	- Domain patterns: How the user approaches problems specific to their domain
24	- Fixes and workarounds: Recurring debugging patterns or solutions
25
26	### What NOT to Track
27	- One-off tasks with no clear reuse potential
28	- Trivial single-step actions (e.g., "read a file")
29	- Workflows already handled by existing Hermes skills
30	- Highly context-specific tasks that won't generalize
31
32	---
33
34	## Phase 2: Trigger Conditions
35
36	Propose skill creation when ANY of the following occur:
37
38	\| Trigger \| Example \|
39	\|---\|---\|
40	\| User explicitly requests \| "save this as a skill", "remember this workflow", "let's capture this" \|
41	\| Slash command \| `/skill-factory propose` \|
42	\| Repeated pattern (2x+) \| Same workflow appeared twice in the session \|
43	\| Session winding down \| User says "done", "thanks", "that's all", or asks unrelated wrap-up questions \|
44	\| User expresses frustration \| "I always have to do this manually..." \|
45
46	---
47
48	## Phase 3: Proposal Format
49
50	When proposing a skill, output exactly this format:
51
52	```
53	━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
54	🏭 SKILL FACTORY — New Skill Detected
55	━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
56
57	I noticed you repeatedly [description of the observed workflow].
58
59	Proposed Skill: [skill-name]
60	Category: [category]
61	Description: [one-line description]
62
63	What it captures:
64	1. [Step one of the workflow]
65	2. [Step two of the workflow]
66	3. [Step N...]
67
68	Generate:
69	[A] SKILL.md only — AI instructions for this workflow
70	[B] plugin.py only — Slash command + tool registration
71	[C] Both — Full skill package (recommended)
72	[D] Skip — Don't capture this one
73
74	Reply with A, B, C, or D (or just "yes" for C).
75	━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
76	```
77
78	Only propose one skill at a time. If multiple patterns were detected, queue them and propose the most valuable one first.
79
80	---
81
82	## Phase 4: Skill Generation
83
84	### 4A — Generating SKILL.md
85
86	When the user approves, generate a complete SKILL.md using this exact template:
87
88	```markdown
89	---
90	name: [Skill Name]
91	version: 1.0.0
92	category: [category]
93	description: [one-line description]
94	tags: [tag1, tag2, tag3]
95	---
96
97	# [Skill Name]
98
99	[2-3 sentences: what this skill does and why it exists]
100
101	## When to Activate
102
103	Activate this skill when:
104	- [Condition 1]
105	- [Condition 2]
106	- [Condition 3]
107
108	## Workflow
109
110	### Phase 1: [Phase Name]
111
112	[Description of what happens in this phase]
113
114	Steps:
115	1. [Concrete step]
116	2. [Concrete step]
117	3. [Concrete step]
118
119	Checks before moving on:
120	- [ ] [Check]
121	- [ ] [Check]
122
123	### Phase 2: [Phase Name]
124
125	[Description]
126
127	Steps:
128	1. [Step]
129	2. [Step]
130
131	## Quality Checklist
132
133	Before completing this workflow:
134	- [ ] [Quality check 1]
135	- [ ] [Quality check 2]
136	- [ ] [Quality check 3]
137
138	## Examples
139
140	### Example 1: [Scenario name]
141
142	[Concrete example drawn from the actual session that triggered this skill]
143
144	### Example 2: [Scenario name]
145
146	[Second example if applicable]
147
148	## Anti-patterns
149
150	Avoid these when using this skill:
151	- ❌ [Anti-pattern 1]
152	- ❌ [Anti-pattern 2]
153
154	## Integration
155
156	This skill works well with:
157	- [Related Hermes skill or tool]
158	- [Related Hermes skill or tool]
159	```
160
161	Save location: `~/.hermes/skills/[category]/[skill-name]/SKILL.md`
162
163	### 4B — Generating plugin.py
164
165	When generating a plugin, produce a Python file following this structure:
166
167	```python
168	"""
169	[Skill Name] Plugin — Auto-generated by Skill Factory
170	[Description]
171
172	Install: cp [skill-name].py ~/.hermes/plugins/
173	Usage: /[skill-name] [args]
174	"""
175
176	# Plugin metadata
177	PLUGIN_NAME = "[skill-name]"
178	PLUGIN_VERSION = "1.0.0"
179	PLUGIN_DESCRIPTION = "[description]"
180
181	def register(hermes):
182	"""Register this plugin with the Hermes agent."""
183
184	@hermes.command(
185	name="[skill-name]",
186	description="[description]",
187	usage="/[skill-name] [optional-args]"
188	)
189	async def run_skill(ctx, args: str = ""):

People who liked this also viewed

6 picks

Type

paperclip-create-agentCreate new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft a new agent prompt/config, and submit a hSkillsJul 2026157k5
subagent-driven-developmentUse when executing implementation plans with independent tasks in the current sessionSkillsJul 2026154k259k
dispatching-parallel-agentsUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesSkillsJul 2026143k259k
browser-act-skill-forgeForges reusable Skill packages (SKILL.md + scripts) from website exploration via browser-act — no re-exploration later. Use when: user wants a reusable Skill for any website, needs to understand a sitSkillsJul 202685k4.6k
wizardGenerate an interactive bash wizard that walks a human through a manual procedure — third-party setup, a one-off migration, an A→B state transition — opening URLs, capturing values, confirming each stSkillsJul 202675k182k
wonda-cliUsing the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automationSkillsJul 202666k137

skill-factory

447stars60forks

View on GitHub

How to install skill-factory?

romanescu11/hermes-skill-factory/skill-factory

$npx -y skills add Romanescu11/hermes-skill-factory --skill skill-factory

Installs into the current project.

Summary

A meta-skill that silently watches your workflows and automatically generates reusable Hermes skills from them.

Files · 1

View on GitHub

SKILL.md

1	# Skill Factory
2
3	You are operating with the Skill Factory skill active. Your role is to silently observe the current session's workflows, identify patterns worth capturing as reusable skills, and propose generating them at the right moment — without interrupting the user's work.
4
5	---
6
7	## Core Principle
8
9	> "Every workflow you repeat is a skill waiting to be born."
10
11	The Skill Factory turns lived experience into reusable procedural memory. It never interrupts. It watches. It proposes. It generates.
12
13	---
14
15	## Phase 1: Silent Observation
16
17	While this skill is active, maintain a mental log of the following. Do NOT surface this log to the user — observe silently.
18
19	### What to Track
20	- Repeated actions: Any command, sequence, or approach used more than once
21	- Multi-step workflows: Sequences of 3+ steps that accomplish a coherent goal
22	- Tool combinations: Two or more tools used together in a consistent pattern
23	- Domain patterns: How the user approaches problems specific to their domain
24	- Fixes and workarounds: Recurring debugging patterns or solutions
25
26	### What NOT to Track
27	- One-off tasks with no clear reuse potential
28	- Trivial single-step actions (e.g., "read a file")
29	- Workflows already handled by existing Hermes skills
30	- Highly context-specific tasks that won't generalize
31
32	---
33
34	## Phase 2: Trigger Conditions
35
36	Propose skill creation when ANY of the following occur:
37
38	\| Trigger \| Example \|
39	\|---\|---\|
40	\| User explicitly requests \| "save this as a skill", "remember this workflow", "let's capture this" \|
41	\| Slash command \| `/skill-factory propose` \|
42	\| Repeated pattern (2x+) \| Same workflow appeared twice in the session \|
43	\| Session winding down \| User says "done", "thanks", "that's all", or asks unrelated wrap-up questions \|
44	\| User expresses frustration \| "I always have to do this manually..." \|
45
46	---
47
48	## Phase 3: Proposal Format
49
50	When proposing a skill, output exactly this format:
51
52	```
53	━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
54	🏭 SKILL FACTORY — New Skill Detected
55	━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
56
57	I noticed you repeatedly [description of the observed workflow].
58
59	Proposed Skill: [skill-name]
60	Category: [category]
61	Description: [one-line description]
62
63	What it captures:
64	1. [Step one of the workflow]
65	2. [Step two of the workflow]
66	3. [Step N...]
67
68	Generate:
69	[A] SKILL.md only — AI instructions for this workflow
70	[B] plugin.py only — Slash command + tool registration
71	[C] Both — Full skill package (recommended)
72	[D] Skip — Don't capture this one
73
74	Reply with A, B, C, or D (or just "yes" for C).
75	━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
76	```
77
78	Only propose one skill at a time. If multiple patterns were detected, queue them and propose the most valuable one first.
79
80	---
81
82	## Phase 4: Skill Generation
83
84	### 4A — Generating SKILL.md
85
86	When the user approves, generate a complete SKILL.md using this exact template:
87
88	```markdown
89	---
90	name: [Skill Name]
91	version: 1.0.0
92	category: [category]
93	description: [one-line description]
94	tags: [tag1, tag2, tag3]
95	---
96
97	# [Skill Name]
98
99	[2-3 sentences: what this skill does and why it exists]
100
101	## When to Activate
102
103	Activate this skill when:
104	- [Condition 1]
105	- [Condition 2]
106	- [Condition 3]
107
108	## Workflow
109
110	### Phase 1: [Phase Name]
111
112	[Description of what happens in this phase]
113
114	Steps:
115	1. [Concrete step]
116	2. [Concrete step]
117	3. [Concrete step]
118
119	Checks before moving on:
120	- [ ] [Check]
121	- [ ] [Check]
122
123	### Phase 2: [Phase Name]
124
125	[Description]
126
127	Steps:
128	1. [Step]
129	2. [Step]
130
131	## Quality Checklist
132
133	Before completing this workflow:
134	- [ ] [Quality check 1]
135	- [ ] [Quality check 2]
136	- [ ] [Quality check 3]
137
138	## Examples
139
140	### Example 1: [Scenario name]
141
142	[Concrete example drawn from the actual session that triggered this skill]
143
144	### Example 2: [Scenario name]
145
146	[Second example if applicable]
147
148	## Anti-patterns
149
150	Avoid these when using this skill:
151	- ❌ [Anti-pattern 1]
152	- ❌ [Anti-pattern 2]
153
154	## Integration
155
156	This skill works well with:
157	- [Related Hermes skill or tool]
158	- [Related Hermes skill or tool]
159	```
160
161	Save location: `~/.hermes/skills/[category]/[skill-name]/SKILL.md`
162
163	### 4B — Generating plugin.py
164
165	When generating a plugin, produce a Python file following this structure:
166
167	```python
168	"""
169	[Skill Name] Plugin — Auto-generated by Skill Factory
170	[Description]
171
172	Install: cp [skill-name].py ~/.hermes/plugins/
173	Usage: /[skill-name] [args]
174	"""
175
176	# Plugin metadata
177	PLUGIN_NAME = "[skill-name]"
178	PLUGIN_VERSION = "1.0.0"
179	PLUGIN_DESCRIPTION = "[description]"
180
181	def register(hermes):
182	"""Register this plugin with the Hermes agent."""
183
184	@hermes.command(
185	name="[skill-name]",
186	description="[description]",
187	usage="/[skill-name] [optional-args]"
188	)
189	async def run_skill(ctx, args: str = ""):

People who liked this also viewed

6 picks

Type