safe-shell-skill

v1.0.0

Quote one or an ordered batch of dynamic shell arguments through structured MCP tools or a CLI fallback.

Codex1 skill1 MCP serverstdio

by Tan2237MIT2updated 1 day ago

Source

$ git clone https://github.com/Tan2237/safe-shell-skill

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

safe-shell-skill/

├── .codex-plugin/plugin.json
├── skills/safe-shell/SKILL.md
└── .mcp.json

Skills1

safe-shellskills/safe-shell/SKILL.md

Quote one or an ordered batch of dynamic data arguments when an agent must compose shell source text for bash, zsh, fish, sh, dash, ksh, PowerShell, pwsh, CMD, or MSYS2. Prefer argv arrays, then the structured safe_shell_quote / safe_shell_quote_many MCP tools, then the sibling safe_shell.py CLI. Never use this skill for command code or shell syntax.

MCP servers1

safe-shellstdio

command: python
args: ./mcp/safe_shell_server.py
cwd: .

Manifests1

.codex-plugin/plugin.json

{
  "name": "safe-shell-skill",
  "version": "1.0.0",
  "description": "Quote one or an ordered batch of dynamic shell arguments through structured MCP tools or a CLI fallback.",
  "author": {
    "name": "Tan2237",
    "email": "tanyu2237@outlook.com",
    "url": "https://github.com/Tan2237"
  },
  "homepage": "https://github.com/Tan2237/safe-shell-skill",
  "repository": "https://github.com/Tan2237/safe-shell-skill",
  "license": "MIT",
  "keywords": [
    "safe-shell",
    "mcp",
    "shell-quoting",
    "command-line",
    "agents"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "safe-shell",
    "shortDescription": "Quote dynamic shell arguments safely",
    "longDescription": "Generate shell-specific source fragments for one or an ordered batch of literal data arguments through persistent structured MCP tools, with CLI fallback for bash, zsh, fish, sh, dash, ksh, PowerShell, pwsh, CMD, and MSYS2.",
    "developerName": "Tan2237",
    "category": "Developer Tools",
    "capabilities": [
      "Interactive"
    ],
    "websiteURL": "https://github.com/Tan2237/safe-shell-skill",
    "defaultPrompt": [
      "Quote this dynamic argument for the shell command I am composing.",
      "Quote these ordered dynamic arguments while preserving their boundaries.",
      "Check whether this value can be represented as one CMD argument."
    ],
    "brandColor": "#4F5D95"
  }
}