Commands Reference
Complete reference for all smdg commands and their options.
Command Overview
| Command | Description |
|---|---|
smdg login | Authenticate with your Smidge account |
smdg logout | Clear stored credentials |
smdg generate | Generate a SKILL.md from source materials |
smdg install | Install a skill to a platform directory |
smdg credits | Check your credit balance |
smdg skills | List your generated skills |
smdg --version | Show CLI version |
smdg --help | Show help information |
smdg login
Authenticate with your Smidge account using the device authorization flow.
Terminalbash
smdg loginOpens your browser to complete authentication. The CLI waits for confirmation and stores the token at ~/.config/smdg-nodejs/config.json.
smdg logout
Clear stored credentials and invalidate the authentication token.
Terminalbash
smdg logoutsmdg generate
Generate a SKILL.md file from one or more source materials.
Terminalbash
smdg generate [options]Options
| Flag | Type | Description |
|---|---|---|
--source, -s | string (repeatable) | File path or URL to use as source material. Specify multiple times for multi-source fusion. |
--name, -n | string | Skill name (auto-slugified to lowercase-hyphenated). Auto-detected from content if omitted. |
--category, -c | string | Skill category. Values: coding, writing, task, devops, testing, documentation, design, other. |
--install, -i | string | Auto-install to platform after generation. Values: claude, codex. |
Example
Terminalbash
smdg generate \
--source ./react-patterns.pdf \
--source "https://youtube.com/watch?v=abc123" \
--name react-patterns \
--category coding \
--install claudesmdg install
Install a generated skill to a platform's skills directory.
Terminalbash
smdg install [options]Options
| Flag | Type | Description |
|---|---|---|
--platform, -p | string (required) | Target platform: claude or codex. |
--skill | string | Name of the skill to install. Defaults to the most recently generated local skill. |
--latest | boolean | Install the latest skill from your Smidge account (fetches from server). |
--project | boolean | Install to project-local directory instead of global. |
smdg credits
Check your current credit balance.
Terminalbash
smdg credits
# Credits: 12 remaining
# Plan: Pro Packsmdg skills
List your generated skills.
Terminalbash
smdg skills
# NAME CATEGORY WORDS CREATED
# css-layout-expert coding 3,421 2025-12-15
# brand-voice writing 2,847 2025-12-14
# code-review task 1,923 2025-12-13Global Options
| Flag | Description |
|---|---|
--version, -v | Print the CLI version and exit. |
--help, -h | Show help for the command. |