skill-acquisition

Name: skill-acquisition
Author: tkellogg

83stars19forks

How to install skill-acquisition?

tkellogg/open-strix/skill-acquisition

$npx -y skills add tkellogg/open-strix --skill skill-acquisition

Installs into the current project.

Summary

Discover, evaluate, install, and wrap external agent skills from ClawHub registry, skillflag-compliant CLI tools, and GitHub repos. Use when asked to find new capabilities, install a skill, browse what's available, or package a local skill for sharing.

Files · 1

View on GitHub

SKILL.md

1	# Skill Acquisition
2
3	You help users discover and install agent skills from the ecosystem. There are three main sources:
4
5	1. ClawHub — Public skill registry (clawhub.ai) with vector search, versioning, and moderation
6	2. Skillflag — CLI tools that bundle their own skills via `--skill list/export`
7	3. GitHub/Raw — Skills as folders in git repos (SKILL.md + supporting files)
8
9	## When to Use This Skill
10
11	USE when:
12	- User asks to find/discover/search for skills or capabilities
13	- User wants to install a skill from ClawHub or a CLI tool
14	- User asks "is there a skill for X?"
15	- User wants to package/publish a local skill
16	- User asks about what skills are available
17
18	DON'T USE when:
19	- User wants to CREATE a new skill from scratch (that's skill-creator)
20	- User wants to modify an existing installed skill (just edit it)
21
22	## Prerequisites
23
24	Both tools run via `npx` — no global install needed, just npm:
25
26	```bash
27	# ClawHub CLI (primary discovery tool)
28	npx clawhub --help
29
30	# Skillflag installer (for CLI-bundled skills)
31	npx skillflag --help
32	```
33
34	## Discovery — Finding Skills
35
36	### 1. ClawHub Search (best for general discovery)
37
38	ClawHub uses vector search (OpenAI embeddings), so natural language queries work:
39
40	```bash
41	# Search by description
42	npx clawhub search "manage docker containers"
43	npx clawhub search "git workflow automation"
44
45	# Browse latest/trending
46	npx clawhub explore # newest 25
47	npx clawhub explore --sort trending # trending now
48	npx clawhub explore --sort downloads # most popular
49
50	# Machine-readable output
51	npx clawhub explore --json
52	npx clawhub search "kubernetes" --json
53	```
54
55	### 2. Skillflag Discovery (for CLI tools you already have)
56
57	Any skillflag-compliant CLI tool bundles its own skills:
58
59	```bash
60	# List skills a tool provides
61	<tool> --skill list
62
63	# See what a skill contains
64	<tool> --skill show <id>
65
66	# JSON metadata (includes digest for integrity)
67	<tool> --skill list --json
68	```
69
70	Known skillflag-compliant tools:
71	- `acpx` — ACP coding agent delegation
72	- Check any CLI you install: `<tool> --skill list` (won't break if unsupported)
73
74	### 3. GitHub Search (for skills not on ClawHub)
75
76	```bash
77	# Search GitHub for SKILL.md files
78	gh search code "filename:SKILL.md" --limit 20
79
80	# The openclaw/skills repo archives ALL ClawHub skills
81	# Browse: https://github.com/openclaw/skills/tree/main/skills
82	```
83
84	## Evaluation — Before Installing
85
86	Always evaluate before installing:
87
88	```bash
89	# Inspect without installing (ClawHub)
90	npx clawhub inspect <slug> # metadata + description
91	npx clawhub inspect <slug> --files # list all files in the skill
92	npx clawhub inspect <slug> --file SKILL.md # read the actual skill content
93
94	# Inspect a skillflag export
95	<tool> --skill show <id> # read SKILL.md content
96	<tool> --skill export <id> \| tar -tf - # list files without installing
97	```
98
99	Evaluation checklist:
100	1. Read the SKILL.md — does it do what you need?
101	2. Check required env vars / bins (`metadata.openclaw.requires`)
102	3. Check file count and what's included (scripts? templates?)
103	4. For ClawHub skills: check install count, version history, last update
104	5. For GitHub skills: check repo stars, recent activity, author reputation
105
106	## Installation — Getting Skills In Place
107
108	### From ClawHub
109
110	```bash
111	# Install to your skills directory
112	npx clawhub install <slug> --workdir "$(pwd)" --dir skills
113	```
114
115	### From Skillflag CLI Tools
116
117	```bash
118	# Into a custom directory (open-strix agents)
119	<tool> --skill export <id> \| npx skillflag install --dest ./skills
120	```
121
122	### From GitHub / Raw
123
124	```bash
125	# Clone just the skill directory
126	git clone --depth 1 <repo-url> /tmp/skill-source
127	cp -r /tmp/skill-source/skills/<name> ./skills/<name>
128	rm -rf /tmp/skill-source
129	```
130
131	### After Installing
132
133	Verify the skill appears in your prompt. Skills in `skills/` are automatically loaded.
134
135	## Wrapping — Adapting Skills for Your Agent
136
137	Raw skills from ClawHub/skillflag may need wrapping. The pattern:
138
139	### When to Wrap
140
141	- Skill assumes capabilities your agent doesn't have (e.g., coding ability)
142	- Skill needs context about WHEN to use it (delegation logic)
143	- Skill's SKILL.md is a CLI reference but you need behavioral guidance
144	- Multiple related skills should be combined into one coherent capability
145
146	### Wrapping Pattern
147
148	Create a wrapper skill that:
149	1. Has its own `SKILL.md` with behavioral instructions (when/how to use)
150	2. Includes the original skill as a reference doc (e.g., `<name>-reference.md`)
151	3. Adds any agent-specific context (delegation, reporting, error handling)
152
153	```
154	skills/my-capability/
155	SKILL.md <- your wrapper (behavioral instructions)
156	<tool>-reference.md <- original skill co

People who liked this also viewed

6 picks

Type

skill-acquisition

83stars19forks

View on GitHub

How to install skill-acquisition?

tkellogg/open-strix/skill-acquisition

$npx -y skills add tkellogg/open-strix --skill skill-acquisition

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Skill Acquisition
2
3	You help users discover and install agent skills from the ecosystem. There are three main sources:
4
5	1. ClawHub — Public skill registry (clawhub.ai) with vector search, versioning, and moderation
6	2. Skillflag — CLI tools that bundle their own skills via `--skill list/export`
7	3. GitHub/Raw — Skills as folders in git repos (SKILL.md + supporting files)
8
9	## When to Use This Skill
10
11	USE when:
12	- User asks to find/discover/search for skills or capabilities
13	- User wants to install a skill from ClawHub or a CLI tool
14	- User asks "is there a skill for X?"
15	- User wants to package/publish a local skill
16	- User asks about what skills are available
17
18	DON'T USE when:
19	- User wants to CREATE a new skill from scratch (that's skill-creator)
20	- User wants to modify an existing installed skill (just edit it)
21
22	## Prerequisites
23
24	Both tools run via `npx` — no global install needed, just npm:
25
26	```bash
27	# ClawHub CLI (primary discovery tool)
28	npx clawhub --help
29
30	# Skillflag installer (for CLI-bundled skills)
31	npx skillflag --help
32	```
33
34	## Discovery — Finding Skills
35
36	### 1. ClawHub Search (best for general discovery)
37
38	ClawHub uses vector search (OpenAI embeddings), so natural language queries work:
39
40	```bash
41	# Search by description
42	npx clawhub search "manage docker containers"
43	npx clawhub search "git workflow automation"
44
45	# Browse latest/trending
46	npx clawhub explore # newest 25
47	npx clawhub explore --sort trending # trending now
48	npx clawhub explore --sort downloads # most popular
49
50	# Machine-readable output
51	npx clawhub explore --json
52	npx clawhub search "kubernetes" --json
53	```
54
55	### 2. Skillflag Discovery (for CLI tools you already have)
56
57	Any skillflag-compliant CLI tool bundles its own skills:
58
59	```bash
60	# List skills a tool provides
61	<tool> --skill list
62
63	# See what a skill contains
64	<tool> --skill show <id>
65
66	# JSON metadata (includes digest for integrity)
67	<tool> --skill list --json
68	```
69
70	Known skillflag-compliant tools:
71	- `acpx` — ACP coding agent delegation
72	- Check any CLI you install: `<tool> --skill list` (won't break if unsupported)
73
74	### 3. GitHub Search (for skills not on ClawHub)
75
76	```bash
77	# Search GitHub for SKILL.md files
78	gh search code "filename:SKILL.md" --limit 20
79
80	# The openclaw/skills repo archives ALL ClawHub skills
81	# Browse: https://github.com/openclaw/skills/tree/main/skills
82	```
83
84	## Evaluation — Before Installing
85
86	Always evaluate before installing:
87
88	```bash
89	# Inspect without installing (ClawHub)
90	npx clawhub inspect <slug> # metadata + description
91	npx clawhub inspect <slug> --files # list all files in the skill
92	npx clawhub inspect <slug> --file SKILL.md # read the actual skill content
93
94	# Inspect a skillflag export
95	<tool> --skill show <id> # read SKILL.md content
96	<tool> --skill export <id> \| tar -tf - # list files without installing
97	```
98
99	Evaluation checklist:
100	1. Read the SKILL.md — does it do what you need?
101	2. Check required env vars / bins (`metadata.openclaw.requires`)
102	3. Check file count and what's included (scripts? templates?)
103	4. For ClawHub skills: check install count, version history, last update
104	5. For GitHub skills: check repo stars, recent activity, author reputation
105
106	## Installation — Getting Skills In Place
107
108	### From ClawHub
109
110	```bash
111	# Install to your skills directory
112	npx clawhub install <slug> --workdir "$(pwd)" --dir skills
113	```
114
115	### From Skillflag CLI Tools
116
117	```bash
118	# Into a custom directory (open-strix agents)
119	<tool> --skill export <id> \| npx skillflag install --dest ./skills
120	```
121
122	### From GitHub / Raw
123
124	```bash
125	# Clone just the skill directory
126	git clone --depth 1 <repo-url> /tmp/skill-source
127	cp -r /tmp/skill-source/skills/<name> ./skills/<name>
128	rm -rf /tmp/skill-source
129	```
130
131	### After Installing
132
133	Verify the skill appears in your prompt. Skills in `skills/` are automatically loaded.
134
135	## Wrapping — Adapting Skills for Your Agent
136
137	Raw skills from ClawHub/skillflag may need wrapping. The pattern:
138
139	### When to Wrap
140
141	- Skill assumes capabilities your agent doesn't have (e.g., coding ability)
142	- Skill needs context about WHEN to use it (delegation logic)
143	- Skill's SKILL.md is a CLI reference but you need behavioral guidance
144	- Multiple related skills should be combined into one coherent capability
145
146	### Wrapping Pattern
147
148	Create a wrapper skill that:
149	1. Has its own `SKILL.md` with behavioral instructions (when/how to use)
150	2. Includes the original skill as a reference doc (e.g., `<name>-reference.md`)
151	3. Adds any agent-specific context (delegation, reporting, error handling)
152
153	```
154	skills/my-capability/
155	SKILL.md <- your wrapper (behavioral instructions)
156	<tool>-reference.md <- original skill co

People who liked this also viewed

6 picks

Type