Skip to content

Commit 8fcc12d

Browse files
ncrmroclaude
andauthored
docs(library): add slash command creation guide to shared jobs readme (#277)
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 88424be commit 8fcc12d

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

library/jobs/README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,28 @@ Shared jobs are stored in the `library/jobs/` directory of the DeepWork reposito
3030
3. **Sets the environment variable** — adds `DEEPWORK_ADDITIONAL_JOBS_FOLDERS` to your `flake.nix` shellHook (or shell profile)
3131
4. **Discovers jobs** — library jobs appear in `/deepwork` alongside your local and standard jobs
3232

33+
## Creating Slash Commands for Jobs
34+
35+
You can ask Claude to turn any job workflow into a slash command for quicker access. The easiest way is a one-liner from your terminal:
36+
37+
```bash
38+
claude "Create a /research slash command from the deepwork research job with subcommands for each workflow"
39+
```
40+
41+
Claude will create skill files under `.claude/skills/` so you can invoke workflows directly:
42+
43+
```
44+
/research # runs research (deep) workflow
45+
/research deep # runs research (deep) workflow
46+
/research quick # runs research (quick) workflow
47+
```
48+
49+
You can also use dot notation for the skill name — `/research.deep` and `/research.quick` — which creates separate skill files for each workflow.
50+
51+
### Why slash commands aren't created automatically
52+
53+
DeepWork does not auto-generate slash commands for every job and workflow. Each slash command becomes a **skill** that is loaded into the agent's context — both for the user and for any sub-agents that spawn during a session. Auto-generating commands for every workflow across every installed job would flood the skill list, increasing token usage and making it harder for agents to select the right tool. Instead, users create slash commands only for the workflows they actually use frequently, keeping the skill surface lean and intentional.
54+
3355
## Purpose
3456

3557
The job library provides:

0 commit comments

Comments
 (0)