Generating Skills via CLI
The smdg generate command creates a SKILL.md file from one or more source materials.
Basic Usage
Terminalbash
smdg generate --source <path-or-url>Examples
Single Local File
Terminalbash
smdg generate --source ./my-guide.pdfYouTube URL
Terminalbash
smdg generate --source "https://youtube.com/watch?v=dQw4w9WgXcQ"Multiple Sources
Terminalbash
smdg generate \
--source ./reference.pdf \
--source "https://youtube.com/watch?v=..." \
--source ./examples.mdWith Options
Terminalbash
smdg generate \
--source ./style-guide.pdf \
--name brand-voice \
--category writing \
--install claudeOptions
| Flag | Description | Default |
|---|---|---|
--source | Source file path or URL. Repeat for multiple sources. | (required) |
--name | Skill name (lowercase-hyphenated). Auto-generated if omitted. | auto |
--category | Skill category (coding, writing, task, devops, etc.). | auto |
--install | Auto-install after generation. Values: claude, codex. | none |
Output
Generated skills are saved to the ./skills/ directory relative to your current working directory:
Output structure
./skills/
└── my-skill/
├── SKILL.md
└── references/ # only if content exceeds word limit
├── part-1.md
└── part-2.mdProgress Display
During generation, the CLI displays real-time progress:
Terminal output
⠋ Uploading sources...
✓ Uploaded 2 sources (142 KB)
⠋ Extracting content...
✓ Extracted 8,421 words from 2 sources
⠋ Synthesizing skill...
✓ Synthesized brand-voice (2,847 words)
⠋ Validating...
✓ Validation passed (8/8 checks)
✓ Saved to ./skills/brand-voice/SKILL.mdTip
Use the
--install flag to skip the manual copy step. The skill will be generated and installed in a single command.