aiskillstore/marketplace / skills/89jobrien/command-optimization
command-optimization
VerifiedCLI command development specialist. Use when creating commands, designing argument parsing, automating tasks, or implementing CLI best practices. Specializes in command design patterns and user experience.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.8 KB |
| references/slash-command.template.md | markdown | 2.2 KB |
| skill-report.json | config | 46.4 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T11:32:25.654Z",
"slug": "89jobrien-command-optimization",
"source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/command-optimization",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "12e120b7570100e5bffbac5f8d27a94a49dc558c68bee2d7d458da3aef71b739",
"tree_hash": "bc7699d6d4ddaab9542046909a48141a9ddc12d150e24849e957687bd05cee93",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "command-optimization",
"description": "Designs and improves command-line interfaces, including command names, argument structures, automation workflows, help text, and error handling.",
"summary": "Designs and improves CLI commands, arguments, help text, and slash command templates.",
"icon": "📦",
"version": "1.0.2",
"author": "Joseph OBrien",
"license": "MIT",
"tags": [
"cli",
"command-design",
"argument-parsing",
"automation",
"slash-commands"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands"
],
"category": "coding"
},
"security_audit": {
"risk_level": "medium",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Most static findings in SKILL.md are false positives from Markdown fences, inline option names, and documented examples. The reference template contains real slash-command dynamic context using shell commands that execute when copied into a command. No prompt injection, data exfiltration intent, or malicious command content was found.",
"remediation": [
{
"issue": "Dynamic shell context can execute local commands when a slash command loads.",
"suggestion": "Add safety guidance to use only deterministic read-only commands, avoid user input, and restrict allowed tools narrowly.",
"severity": "medium"
},
{
"issue": "Template placeholders allow arbitrary shell commands in generated slash commands.",
"suggestion": "Tell users to remove placeholders and review every shell command before publishing a generated command.",
"severity": "medium"
},
{
"issue": "Shell command examples lack an explicit safety warning.",
"suggestion": "Mark examples as documentation and add a short warning before dynamic context examples.",
"severity": "low"
}
],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "references/slash-command.template.md",
"line_start": 79,
"line_end": 80
},
{
"file": "references/slash-command.template.md",
"line_start": 80,
"line_end": 81
},
{
"file": "SKILL.md",
"line_start": 40,
"line_end": 42
},
{
"file": "SKILL.md",
"line_start": 42,
"line_end": 44
},
{
"file": "SKILL.md",
"line_start": 44,
"line_end": 46
},
{
"file": "SKILL.md",
"line_start": 46,
"line_end": 50
},
{
"file": "SKILL.md",
"line_start": 50,
"line_end": 52
},
{
"file": "SKILL.md",
"line_start": 52,
"line_end": 67
},
{
"file": "SKILL.md",
"line_start": 67,
"line_end": 73
},
{
"file": "SKILL.md",
"line_start": 73,
"line_end": 86
},
{
"file": "SKILL.md",
"line_start": 86,
"line_end": 92
},
{
"file": "SKILL.md",
"line_start": 92,
"line_end": 107
},
{
"file": "SKILL.md",
"line_start": 107,
"line_end": 116
},
{
"file": "SKILL.md",
"line_start": 116,
"line_end": 122
},
{
"file": "SKILL.md",
"line_start": 122,
"line_end": 123
},
{
"file": "SKILL.md",
"line_start": 123,
"line_end": 124
},
{
"file": "SKILL.md",
"line_start": 124,
"line_end": 125
},
{
"file": "SKILL.md",
"line_start": 125,
"line_end": 126
},
{
"file": "SKILL.md",
"line_start": 126,
"line_end": 151
},
{
"file": "SKILL.md",
"line_start": 151,
"line_end": 158
},
{
"file": "SKILL.md",
"line_start": 158,
"line_end": 168
},
{
"file": "SKILL.md",
"line_start": 168,
"line_end": 172
},
{
"file": "SKILL.md",
"line_start": 172,
"line_end": 174
},
{
"file": "SKILL.md",
"line_start": 174,
"line_end": 178
},
{
"file": "SKILL.md",
"line_start": 178,
"line_end": 179
},
{
"file": "SKILL.md",
"line_start": 179,
"line_end": 180
},
{
"file": "SKILL.md",
"line_start": 180,
"line_end": 181
},
{
"file": "SKILL.md",
"line_start": 181,
"line_end": 185
},
{
"file": "SKILL.md",
"line_start": 185,
"line_end": 191
},
{
"file": "SKILL.md",
"line_start": 191,
"line_end": 195
},
{
"file": "SKILL.md",
"line_start": 195,
"line_end": 207
},
{
"file": "SKILL.md",
"line_start": 207,
"line_end": 215
},
{
"file": "SKILL.md",
"line_start": 215,
"line_end": 219
},
{
"file": "SKILL.md",
"line_start": 219,
"line_end": 221
},
{
"file": "SKILL.md",
"line_start": 221,
"line_end": 225
},
{
"file": "SKILL.md",
"line_start": 225,
"line_end": 226
},
{
"file": "SKILL.md",
"line_start": 226,
"line_end": 227
},
{
"file": "SKILL.md",
"line_start": 227,
"line_end": 228
},
{
"file": "SKILL.md",
"line_start": 228,
"line_end": 232
},
{
"file": "SKILL.md",
"line_start": 232,
"line_end": 244
},
{
"file": "SKILL.md",
"line_start": 244,
"line_end": 246
},
{
"file": "SKILL.md",
"line_start": 246,
"line_end": 250
}
]
}
],
"static_findings": [
{
"id": "external_commands:references/slash-command.template.md:79:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "references/slash-command.template.md",
"line_start": 79,
"line_end": 80,
"snippet": "- Current branch: !`git branch --show-current`"
},
{
"id": "external_commands:references/slash-command.template.md:80:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "references/slash-command.template.md",
"line_start": 80,
"line_end": 81,
"snippet": "- File count: !`find . -name \"*.py\" | wc -l`"
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 40,
"line_end": 42,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 42,
"line_end": 44,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 44,
"line_end": 46,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 46,
"line_end": 50,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 50,
"line_end": 52,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 52,
"line_end": 67,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 67,
"line_end": 73,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 73,
"line_end": 86,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 86,
"line_end": 92,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 92,
"line_end": 107,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 107,
"line_end": 116,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 116,
"line_end": 122,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 122,
"line_end": 123,
"snippet": "- `--config`: Custom configuration file"
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 123,
"line_end": 124,
"snippet": "- `--output`: Output directory or format"
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 124,
"line_end": 125,
"snippet": "- `--verbose`: Detailed logging"
},
{
"id": "external_commands:SKILL.md:125:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 125,
"line_end": 126,
"snippet": "- `--dry-run`: Preview without execution"
},
{
"id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 126,
"line_end": 151,
"snippet": "- `--force`: Override safety checks"
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 151,
"line_end": 158,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 158,
"line_end": 168,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 168,
"line_end": 172,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 172,
"line_end": 174,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 174,
"line_end": 178,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 178,
"line_end": 179,
"snippet": "- `--path <path>`: Output path (default: src/components)"
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 179,
"line_end": 180,
"snippet": "- `--type <type>`: Component type (functional|class) (default: functional)"
},
{
"id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 180,
"line_end": 181,
"snippet": "- `--with-tests`: Generate test file"
},
{
"id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 181,
"line_end": 185,
"snippet": "- `--with-styles`: Generate stylesheet"
},
{
"id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 185,
"line_end": 191,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:191:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 191,
"line_end": 195,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:195:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 195,
"line_end": 207,
"snippet": "```javascript"
},
{
"id": "external_commands:SKILL.md:207:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 207,
"line_end": 215,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:215:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 215,
"line_end": 219,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:219:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 219,
"line_end": 221,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:221:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 221,
"line_end": 225,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:225:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 225,
"line_end": 226,
"snippet": "- `--create <table>`: Create new migration for table"
},
{
"id": "external_commands:SKILL.md:226:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 226,
"line_end": 227,
"snippet": "- `--rollback`: Rollback last migration"
},
{
"id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 227,
"line_end": 228,
"snippet": "- `--status`: Show migration status"
},
{
"id": "external_commands:SKILL.md:228:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 228,
"line_end": 232,
"snippet": "- `--to <version>`: Migrate to specific version"
},
{
"id": "external_commands:SKILL.md:232:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 232,
"line_end": 244,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:244:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 244,
"line_end": 246,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:246:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 246,
"line_end": 250,
"snippet": "```"
}
],
"finding_verdicts": [
{
"id": "external_commands:references/slash-command.template.md:79:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.78,
"reason": "The reference documents slash-command dynamic context with shell commands that execute when a command loads. The examples are benign, but the pattern enables load-time external command execution in generated commands.",
"severity": "medium"
},
{
"id": "external_commands:references/slash-command.template.md:80:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.78,
"reason": "The reference documents slash-command dynamic context with shell commands that execute when a command loads. The examples are benign, but the pattern enables load-time external command execution in generated commands.",
"severity": "medium"
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:125:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:191:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:195:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:207:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:215:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:219:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:221:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:225:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:226:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:228:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is an inline Markdown option name, not shell execution. It documents CLI flags and does not direct the agent to run a command."
},
{
"id": "external_commands:SKILL.md:232:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:244:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
},
{
"id": "external_commands:SKILL.md:246:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The snippet is a Markdown code fence or documented CLI example, not an executable directive. The surrounding section teaches command design patterns rather than triggering hidden command execution."
}
],
"semantic_findings": [
{
"title": "Load-Time Shell Execution in Slash Command Template",
"description": "The slash command template tells users to use dynamic context shell commands that execute when a command loads. This can run local commands if a generated command keeps unsafe dynamic context or accepts unreviewed shell placeholders.",
"severity": "medium",
"locations": [
{
"file": "references/slash-command.template.md",
"line_start": 24,
"line_end": 25
},
{
"file": "references/slash-command.template.md",
"line_start": 74,
"line_end": 80
}
],
"confidence": 0.86,
"confidence_reasoning": "The file explicitly states that dynamic context shell commands execute when the command loads. The examples are read-only, so the risk is contextual rather than evidence of malicious intent."
}
],
"critical_findings": [],
"high_findings": [],
"medium_findings": [
{
"title": "Ruby/shell backtick execution",
"description": "- Current branch: !`git branch --show-current`",
"locations": [
{
"file": "references/slash-command.template.md",
"line_start": 79,
"line_end": 80
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.78,
"confidence_reasoning": "The reference documents slash-command dynamic context with shell commands that execute when a command loads. The examples are benign, but the pattern enables load-time external command execution in generated commands."
},
{
"title": "Ruby/shell backtick execution",
"description": "- File count: !`find . -name \"*.py\" | wc -l`",
"locations": [
{
"file": "references/slash-command.template.md",
"line_start": 80,
"line_end": 81
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.78,
"confidence_reasoning": "The reference documents slash-command dynamic context with shell commands that execute when a command loads. The examples are benign, but the pattern enables load-time external command execution in generated commands."
},
{
"title": "Load-Time Shell Execution in Slash Command Template",
"description": "The slash command template tells users to use dynamic context shell commands that execute when a command loads. This can run local commands if a generated command keeps unsafe dynamic context or accepts unreviewed shell placeholders.",
"locations": [
{
"file": "references/slash-command.template.md",
"line_start": 24,
"line_end": 25
},
{
"file": "references/slash-command.template.md",
"line_start": 74,
"line_end": 80
}
],
"review_kind": "security",
"source_category": "semantic",
"source_severity": "medium",
"confidence": 0.86,
"confidence_reasoning": "The file explicitly states that dynamic context shell commands execute when the command loads. The examples are read-only, so the risk is contextual rather than evidence of malicious intent."
}
],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 2,
"total_lines": 402,
"audit_model": "codex",
"audited_at": "2026-07-05T11:32:25.654Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Design Better CLI Commands",
"value_statement": "CLI commands often grow inconsistent, unclear, or hard to maintain. This skill helps Claude, Codex, and Claude Code design usable commands, arguments, error handling, and documentation.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"CLI command design",
"command optimization",
"argument parsing",
"slash commands",
"developer automation",
"command documentation",
"CLI user experience"
],
"actual_capabilities": [
"Designs task-oriented CLI command names, options, and usage patterns.",
"Reviews command examples for clearer arguments and safer defaults.",
"Drafts help text, error messages, and usage documentation.",
"Creates slash command templates with frontmatter, arguments, workflows, and output formats.",
"Explains validation, dry-run, confirmation, and verbose-mode patterns."
],
"limitations": [
"It provides guidance and templates, not a tested CLI framework.",
"It does not include executable scripts or argument-parsing libraries.",
"Dynamic shell context in slash command templates requires careful review before use.",
"Generated commands still need project-specific implementation and tests."
],
"use_cases": [
{
"title": "Create Developer Commands",
"description": "Design a new project command with clear usage, options, examples, and validation rules.",
"target_user": "Application developers"
},
{
"title": "Improve Existing CLI Workflows",
"description": "Review confusing commands and refine names, flags, feedback, and error messages.",
"target_user": "Tool maintainers"
},
{
"title": "Standardize Slash Command Templates",
"description": "Draft reusable slash command structure with frontmatter, arguments, workflow steps, and output format.",
"target_user": "AI workflow teams"
}
],
"prompt_templates": [
{
"title": "Draft a Basic Command",
"scenario": "Beginner command design",
"prompt": "Create a simple CLI command for [task]. Include the command name, purpose, required arguments, optional flags, and one usage example."
},
{
"title": "Improve a Command Interface",
"scenario": "Intermediate command review",
"prompt": "Review this command: [command]. Improve the name, arguments, options, help text, validation, and error messages."
},
{
"title": "Create a Safe Slash Command Template",
"scenario": "Advanced slash command authoring",
"prompt": "Design a slash command template for [workflow]. Include frontmatter, arguments, workflow steps, output format, and safety notes for any dynamic context."
},
{
"title": "Design a Command Suite",
"scenario": "Advanced project automation",
"prompt": "Create a command suite for [project workflow]. Define consistent command names, shared options, validation rules, dry-run behavior, and documentation structure."
}
],
"output_examples": [
{
"input": "Create a command for generating React components.",
"output": [
"A task-focused command name with a clear component target.",
"Recommended options for path, component type, tests, and styles.",
"Validation guidance for missing names and invalid output paths."
]
},
{
"input": "Improve a vague dependency check command.",
"output": [
"A clearer command name that states the analysis goal.",
"Output format options for summary and detailed results.",
"Actionable error messages and next-step recommendations."
]
},
{
"input": "Create a slash command template for project cleanup.",
"output": [
"Frontmatter fields for description, argument hint, and tool limits.",
"A structured workflow with current state, task steps, and final output.",
"A safety reminder for any dynamic shell context."
]
}
],
"best_practices": [
"Start with a clear action verb, target object, and one primary task.",
"Add dry-run, confirmation, and validation for commands that change files or data.",
"Keep examples, help text, and error messages aligned with real project conventions."
],
"anti_patterns": [
"Using vague command names such as check, run, or make without context.",
"Adding force or rollback options without safeguards or clear warnings.",
"Copying dynamic shell context into slash commands without reviewing what executes."
],
"faq": [
{
"question": "Does this skill write production CLI code?",
"answer": "It drafts command designs, examples, and guidance. You still need to implement and test the final code."
},
{
"question": "Can it help with argument parsing?",
"answer": "Yes. It can design arguments, options, defaults, validation rules, and help text."
},
{
"question": "Does it support slash commands?",
"answer": "Yes. It includes a slash command template with frontmatter, arguments, workflow sections, and output format guidance."
},
{
"question": "Is dynamic shell context safe?",
"answer": "It can be useful, but every shell command must be reviewed and limited to safe read-only behavior."
},
{
"question": "Who should use this skill?",
"answer": "Developers, tool maintainers, and AI workflow authors can use it to improve command design."
},
{
"question": "What tools can use this skill?",
"answer": "The report lists support for Claude, Codex, and Claude Code."
}
]
},
"file_structure": [
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "slash-command.template.md",
"type": "file",
"path": "references/slash-command.template.md",
"lines": 118
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 284
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |