CLI Flags Reference

Global

skillx [command] [options]

Flag	Description
--version	Print version information
--help	Print help information

skillx run

skillx run <source> [prompt] [options]

Arguments

Argument	Position	Required	Description
source	1	Yes	Skill source (local path, github: prefix, or GitHub URL)
prompt	2	No	Prompt text to pass to the agent

Flags

Flag	Short	Type	Default	Description
--file	-f	string	—	Read prompt from a file path
--stdin	—	bool	false	Read prompt from stdin
--agent	—	string	auto-detect	Agent name: claude-code, codex, copilot, cursor, universal
--scope	—	string	global	Injection scope: global or project
--attach	—	string[]	—	Attach files for the agent (repeatable)
--no-cache	—	bool	false	Force re-fetch, skip cache
--skip-scan	—	bool	false	Skip the security scan
--yes	—	bool	false	Auto-confirm WARN level risks
--yolo	—	bool	false	Pass permission-skip flags to the agent
--timeout	—	string	—	Max run duration (e.g., 30m, 2h, 300s)

Prompt Resolution Priority

1. Positional prompt argument
2. --file / -f flag
3. --stdin flag
4. No prompt (agent launches without one)

Duration Format

The --timeout flag accepts human-friendly durations:

Suffix	Unit	Example
s	Seconds	300s
m	Minutes	30m
h	Hours	2h
d	Days	1d

Examples

skillx run ./my-skill "prompt"
skillx run -f prompt.txt github:org/repo/skill
echo "prompt" | skillx run --stdin ./skill
skillx run --agent codex --yolo --timeout 1h ./skill "prompt"
skillx run --scope project --attach data.csv ./skill "analyze"

skillx install

skillx install [sources...] [options]

Arguments

Argument	Position	Required	Description
sources	1+	No	Skill source(s). If omitted, installs from skillx.toml

Flags

Flag	Type	Default	Description
--agent	string	auto-detect	Target a specific agent (conflicts with --all)
--all	bool	false	Install to all detected agents (conflicts with --agent)
--scope	string	global	Injection scope: global or project
--no-cache	bool	false	Force re-fetch, skip cache
--skip-scan	bool	false	Skip security scan
--yes	bool	false	Auto-confirm WARN level risks
--no-save	bool	false	Don’t save to skillx.toml
--dev	bool	false	Install as dev dependency
--prod	bool	false	Only install production dependencies, skip dev
--prune	bool	false	Remove installed skills not in skillx.toml

Examples

skillx install github:org/skills/pdf
skillx install --all --dev github:org/skills/testing
skillx install                  # from skillx.toml
skillx install --prod --prune   # production only, prune extras

skillx uninstall

skillx uninstall <name...> [options]

Arguments

Argument	Position	Required	Description
names	1+	Yes	Skill name(s) to uninstall

Flags

Flag	Type	Default	Description
--agent	string	—	Only remove from a specific agent
--keep-in-toml	bool	false	Keep the entry in skillx.toml
--purge	bool	false	Also remove cached files

Examples

skillx uninstall pdf-processing
skillx uninstall formatter --agent cursor
skillx uninstall old-skill --purge

skillx list

skillx list [options]

Flags

Flag	Type	Default	Description
--agent	string	—	Filter by agent
--scope	string	all	Filter by scope: project, global, or all
--json	bool	false	Output as JSON (to stdout)
--outdated	bool	false	Check for available updates

Examples

skillx list
skillx list --agent claude-code
skillx list --json | jq '.[].name'
skillx list --outdated

skillx update

skillx update [names...] [options]

Arguments

Argument	Position	Required	Description
names	1+	No	Skill name(s) to update. If omitted, checks all

Flags

Flag	Type	Default	Description
--agent	string	—	Only update for a specific agent
--dry-run	bool	false	Show what would be updated without applying
--skip-scan	bool	false	Skip security scan
--yes	bool	false	Auto-confirm (skip update prompt)

Examples

skillx update
skillx update --dry-run
skillx update pdf-processing --yes

skillx init

skillx init [options]

Flags

Flag	Type	Default	Description
--from-installed	bool	false	Pre-populate with currently installed skills

Examples

skillx init
skillx init --from-installed

skillx scan

skillx scan <source> [options]

Arguments

Argument	Position	Required	Description
source	1	Yes	Skill source to scan

Flags

Flag	Type	Default	Description
--format	string	text	Output format: text, json, or sarif
--fail-on	string	danger	Exit code threshold: info, warn, danger, block

Output Routing

• text format: output to stderr
• json / sarif format: output to stdout (pipeable)

Examples

skillx scan ./my-skill
skillx scan --format json github:org/repo/skill
skillx scan --format sarif ./my-skill
skillx scan --fail-on warn ./my-skill

skillx agents

skillx agents [options]

Flags

Flag	Type	Default	Description
--all	bool	false	Show all known agents, including undetected

Examples

skillx agents
skillx agents --all

skillx info

skillx info <source>

Arguments

Argument	Position	Required	Description
source	1	Yes	Skill source to inspect

Show metadata parsed from the skill’s SKILL.md frontmatter.

Examples

skillx info ./my-skill
skillx info github:org/repo/skill

skillx cache

skillx cache <subcommand>

Subcommands

Subcommand	Description
ls	List all cached skills with source and timestamp
clean	Remove all cached skill entries

Examples

skillx cache ls
skillx cache clean

Environment Variables

Variable	Description
GITHUB_TOKEN	GitHub personal access token for private repositories

Exit Codes

Code	Applies To	Meaning
0	All commands	Success
1	All commands	Error or threshold exceeded

For skillx scan, exit code 1 means findings were found at or above the --fail-on threshold. For skillx run, exit code 1 means the run could not complete (source resolution failed, scan blocked, agent error, etc.).