Skip to content

aiskillstore/marketplace / skills/89jobrien/shell-scripting

shell-scripting

Verified

Shell scripting best practices and patterns. Use when writing bash/zsh scripts, automating tasks, creating CLI tools, or debugging shell commands.

FileKindSize
SKILL.mdskill md6.7 KB
skill-report.jsonconfig42.3 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-09T01:46:49.423Z",
    "slug": "89jobrien-shell-scripting",
    "source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/shell-scripting",
    "source_ref": "main",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "1c235d8c8c358a099fc9c38ae08a5ee187e7e89cbf7056a5bf1dfb4f16f7ebb9",
    "tree_hash": "32957b201bd201366035909c3008122404ef5e8f8d4af7b1838a1f6bafd9ed7b",
    "provenance": {
      "model_requested": "claude-sonnet-4.6",
      "model_effective": "claude:claude-sonnet-4.6",
      "fallback_chain": [
        {
          "agent": "claude",
          "model": "claude-sonnet-4.6",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "shell-scripting",
    "description": "Guides Claude, Codex, and Claude Code through safe Bash and zsh scripting patterns for automation, CLI tools, and shell debugging.",
    "summary": "Write safer Bash and zsh scripts with templates, error handling, input parsing, and text processing patterns.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "Joseph OBrien",
    "license": "MIT",
    "tags": [
      "shell",
      "bash",
      "zsh",
      "automation",
      "cli-tools"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "filesystem"
    ],
    "category": "devops"
  },
  "security_audit": {
    "risk_level": "critical",
    "is_blocked": true,
    "safe_to_publish": false,
    "analysis_status": "ok",
    "summary": "Most static findings are false positives caused by Markdown code fences, inline shell syntax, and benign shell examples. One finding is confirmed: the text processing example reads /etc/passwd, which is a sensitive host file and should not appear as a general-purpose scripting example.",
    "remediation": [
      {
        "issue": "The text processing example reads /etc/passwd.",
        "suggestion": "Replace the /etc/passwd example with a harmless sample file such as users.txt or data.txt while keeping the same awk delimiter lesson.",
        "severity": "critical"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 31,
            "line_end": 96
          },
          {
            "file": "SKILL.md",
            "line_start": 96,
            "line_end": 102
          },
          {
            "file": "SKILL.md",
            "line_start": 102,
            "line_end": 107
          },
          {
            "file": "SKILL.md",
            "line_start": 107,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 120
          },
          {
            "file": "SKILL.md",
            "line_start": 120,
            "line_end": 124
          },
          {
            "file": "SKILL.md",
            "line_start": 124,
            "line_end": 141
          },
          {
            "file": "SKILL.md",
            "line_start": 141,
            "line_end": 147
          },
          {
            "file": "SKILL.md",
            "line_start": 147,
            "line_end": 162
          },
          {
            "file": "SKILL.md",
            "line_start": 162,
            "line_end": 166
          },
          {
            "file": "SKILL.md",
            "line_start": 166,
            "line_end": 183
          },
          {
            "file": "SKILL.md",
            "line_start": 183,
            "line_end": 187
          },
          {
            "file": "SKILL.md",
            "line_start": 187,
            "line_end": 202
          },
          {
            "file": "SKILL.md",
            "line_start": 202,
            "line_end": 208
          },
          {
            "file": "SKILL.md",
            "line_start": 208,
            "line_end": 232
          },
          {
            "file": "SKILL.md",
            "line_start": 232,
            "line_end": 236
          },
          {
            "file": "SKILL.md",
            "line_start": 236,
            "line_end": 256
          },
          {
            "file": "SKILL.md",
            "line_start": 256,
            "line_end": 262
          },
          {
            "file": "SKILL.md",
            "line_start": 262,
            "line_end": 276
          },
          {
            "file": "SKILL.md",
            "line_start": 276,
            "line_end": 280
          },
          {
            "file": "SKILL.md",
            "line_start": 280,
            "line_end": 297
          },
          {
            "file": "SKILL.md",
            "line_start": 297,
            "line_end": 303
          },
          {
            "file": "SKILL.md",
            "line_start": 303,
            "line_end": 325
          },
          {
            "file": "SKILL.md",
            "line_start": 325,
            "line_end": 331
          },
          {
            "file": "SKILL.md",
            "line_start": 331,
            "line_end": 332
          },
          {
            "file": "SKILL.md",
            "line_start": 332,
            "line_end": 332
          },
          {
            "file": "SKILL.md",
            "line_start": 333,
            "line_end": 335
          },
          {
            "file": "SKILL.md",
            "line_start": 335,
            "line_end": 336
          },
          {
            "file": "SKILL.md",
            "line_start": 336,
            "line_end": 337
          },
          {
            "file": "SKILL.md",
            "line_start": 337,
            "line_end": 342
          },
          {
            "file": "SKILL.md",
            "line_start": 342,
            "line_end": 343
          },
          {
            "file": "SKILL.md",
            "line_start": 343,
            "line_end": 350
          },
          {
            "file": "SKILL.md",
            "line_start": 41,
            "line_end": 41
          },
          {
            "file": "SKILL.md",
            "line_start": 42,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 61,
            "line_end": 61
          },
          {
            "file": "SKILL.md",
            "line_start": 333,
            "line_end": 333
          },
          {
            "file": "SKILL.md",
            "line_start": 31,
            "line_end": 96
          },
          {
            "file": "SKILL.md",
            "line_start": 333,
            "line_end": 333
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 126,
            "line_end": 126
          },
          {
            "file": "SKILL.md",
            "line_start": 293,
            "line_end": 293
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 31,
        "line_end": 96,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 96,
        "line_end": 102,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 102,
        "line_end": 107,
        "snippet": "```bash"
      },
      {
        "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": 111,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 111,
        "line_end": 120,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 120,
        "line_end": 124,
        "snippet": "```"
      },
      {
        "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": 141,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 141,
        "line_end": 147,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 147,
        "line_end": 162,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 162,
        "line_end": 166,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 166,
        "line_end": 183,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 183,
        "line_end": 187,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:187:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 187,
        "line_end": 202,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 202,
        "line_end": 208,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 208,
        "line_end": 232,
        "snippet": "```bash"
      },
      {
        "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": 236,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:236:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 236,
        "line_end": 256,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:256:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 256,
        "line_end": 262,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 262,
        "line_end": 276,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:276:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 276,
        "line_end": 280,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:280:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 280,
        "line_end": 297,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:297:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 297,
        "line_end": 303,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:303:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 303,
        "line_end": 325,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:325:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 325,
        "line_end": 331,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:331:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 331,
        "line_end": 332,
        "snippet": "- Quote all variable expansions: `\"$VAR\"`"
      },
      {
        "id": "external_commands:SKILL.md:332:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 332,
        "line_end": 332,
        "snippet": "- Use `[[ ]]` over `[ ]` for tests"
      },
      {
        "id": "external_commands:SKILL.md:333:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 333,
        "line_end": 335,
        "snippet": "- Use `$(command)` over backticks"
      },
      {
        "id": "external_commands:SKILL.md:335:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 335,
        "line_end": 336,
        "snippet": "- Use `readonly` for constants"
      },
      {
        "id": "external_commands:SKILL.md:336:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 336,
        "line_end": 337,
        "snippet": "- Use `local` in functions"
      },
      {
        "id": "external_commands:SKILL.md:337:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 337,
        "line_end": 342,
        "snippet": "- Provide `--help` option"
      },
      {
        "id": "external_commands:SKILL.md:342:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 342,
        "line_end": 343,
        "snippet": "- Parse `ls` output"
      },
      {
        "id": "external_commands:SKILL.md:343:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 343,
        "line_end": 350,
        "snippet": "- Use `eval` with untrusted input"
      },
      {
        "id": "external_commands:SKILL.md:41:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "SKILL.md",
        "line_start": 41,
        "line_end": 41,
        "snippet": "readonly SCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\""
      },
      {
        "id": "external_commands:SKILL.md:42:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "SKILL.md",
        "line_start": 42,
        "line_end": 42,
        "snippet": "readonly SCRIPT_NAME=\"$(basename \"${BASH_SOURCE[0]}\")\""
      },
      {
        "id": "external_commands:SKILL.md:61:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "SKILL.md",
        "line_start": 61,
        "line_end": 61,
        "snippet": "echo \"[$(date +'%Y-%m-%d %H:%M:%S')] $*\" >&2"
      },
      {
        "id": "external_commands:SKILL.md:333:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "SKILL.md",
        "line_start": 333,
        "line_end": 333,
        "snippet": "- Use `$(command)` over backticks"
      },
      {
        "id": "external_commands:SKILL.md:31:template-literal-with-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Template literal with command substitution",
        "file": "SKILL.md",
        "line_start": 31,
        "line_end": 96,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:333:template-literal-with-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Template literal with command substitution",
        "file": "SKILL.md",
        "line_start": 333,
        "line_end": 333,
        "snippet": "- Use `$(command)` over backticks"
      },
      {
        "id": "filesystem:SKILL.md:126:standard-device-file-access",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Standard device file access",
        "file": "SKILL.md",
        "line_start": 126,
        "line_end": 126,
        "snippet": "command -v jq >/dev/null 2>&1 || error \"jq is required but not installed\""
      },
      {
        "id": "filesystem:SKILL.md:293:standard-device-file-access",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Standard device file access",
        "file": "SKILL.md",
        "line_start": 293,
        "line_end": 293,
        "snippet": "command > /dev/null 2>&1"
      },
      {
        "id": "sensitive:SKILL.md:313:certificate-key-files",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Certificate/key files",
        "file": "SKILL.md",
        "line_start": 313,
        "line_end": 313,
        "snippet": "jq '.key' file.json"
      },
      {
        "id": "blocker:SKILL.md:318:system-password-file-access",
        "category": "blocker",
        "severity": "critical",
        "pattern": "System password file access",
        "file": "SKILL.md",
        "line_start": 318,
        "line_end": 318,
        "snippet": "awk -F: '{print $1}' /etc/passwd  # Custom delimiter"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:187:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:232:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:236:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:256:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:276:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:280:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:297:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:303:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:325:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The analyzer matched Markdown code fences rather than executable Ruby or shell backticks. This is documentation structure, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:331:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The match is inline Markdown formatting around shell terms, not Ruby backtick execution. It contains no executable command path or untrusted input interpolation."
      },
      {
        "id": "external_commands:SKILL.md:332:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The match is inline Markdown formatting around shell terms, not Ruby backtick execution. It contains no executable command path or untrusted input interpolation."
      },
      {
        "id": "external_commands:SKILL.md:333:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The text recommends command-substitution style in prose and does not include executable Ruby backticks. This is shell style guidance, not a runtime execution sink."
      },
      {
        "id": "external_commands:SKILL.md:335:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The match is inline Markdown formatting around shell terms, not Ruby backtick execution. It contains no executable command path or untrusted input interpolation."
      },
      {
        "id": "external_commands:SKILL.md:336:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The match is inline Markdown formatting around shell terms, not Ruby backtick execution. It contains no executable command path or untrusted input interpolation."
      },
      {
        "id": "external_commands:SKILL.md:337:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The match is inline Markdown formatting around shell terms, not Ruby backtick execution. It contains no executable command path or untrusted input interpolation."
      },
      {
        "id": "external_commands:SKILL.md:342:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The match is inline Markdown formatting around shell terms, not Ruby backtick execution. It contains no executable command path or untrusted input interpolation."
      },
      {
        "id": "external_commands:SKILL.md:343:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The text explicitly warns not to use eval with untrusted input. It is a safety recommendation, not an instruction to execute untrusted code."
      },
      {
        "id": "external_commands:SKILL.md:41:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The command substitution appears in a shell script template using fixed utility calls such as dirname, basename, or date. The example quotes variables and does not interpolate untrusted input into executable command text."
      },
      {
        "id": "external_commands:SKILL.md:42:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The command substitution appears in a shell script template using fixed utility calls such as dirname, basename, or date. The example quotes variables and does not interpolate untrusted input into executable command text."
      },
      {
        "id": "external_commands:SKILL.md:61:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The command substitution appears in a shell script template using fixed utility calls such as dirname, basename, or date. The example quotes variables and does not interpolate untrusted input into executable command text."
      },
      {
        "id": "external_commands:SKILL.md:333:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "This is prose recommending modern command substitution syntax over backticks. It does not execute a command or create an injection path by itself."
      },
      {
        "id": "external_commands:SKILL.md:31:template-literal-with-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The match is inside Markdown documentation showing shell syntax, not application code building commands. No user-controlled template literal execution is present."
      },
      {
        "id": "external_commands:SKILL.md:333:template-literal-with-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The match is inside Markdown documentation showing shell syntax, not application code building commands. No user-controlled template literal execution is present."
      },
      {
        "id": "filesystem:SKILL.md:126:standard-device-file-access",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The /dev/null redirection is a standard shell idiom for suppressing command output. It does not read or modify sensitive files."
      },
      {
        "id": "filesystem:SKILL.md:293:standard-device-file-access",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The /dev/null redirection is a standard shell idiom for suppressing command output. It does not read or modify sensitive files."
      },
      {
        "id": "sensitive:SKILL.md:313:certificate-key-files",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The snippet queries a JSON field named '.key' from file.json and does not reference certificate or private-key files. It is a generic jq example, not credential access."
      },
      {
        "id": "blocker:SKILL.md:318:system-password-file-access",
        "verdict": "confirmed",
        "confidence": 0.93,
        "severity": "critical",
        "reason": "The example directly reads /etc/passwd, a sensitive system account file. Even as documentation, this normalizes access to sensitive host data in generated shell commands."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [
      {
        "title": "System password file access",
        "description": "awk -F: '{print $1}' /etc/passwd  # Custom delimiter",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 318,
            "line_end": 318
          }
        ],
        "review_kind": "security",
        "source_category": "blocker",
        "source_severity": "critical",
        "confidence": 0.93,
        "confidence_reasoning": "The example directly reads /etc/passwd, a sensitive system account file. Even as documentation, this normalizes access to sensitive host data in generated shell commands."
      }
    ],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [
      {
        "title": "System password file access",
        "description": "awk -F: '{print $1}' /etc/passwd  # Custom delimiter",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 318,
            "line_end": 318
          }
        ],
        "review_kind": "security",
        "source_category": "blocker",
        "source_severity": "critical",
        "confidence": 0.93,
        "confidence_reasoning": "The example directly reads /etc/passwd, a sensitive system account file. Even as documentation, this normalizes access to sensitive host data in generated shell commands."
      }
    ],
    "files_scanned": 1,
    "total_lines": 357,
    "audit_model": "claude",
    "audited_at": "2026-07-09T01:46:49.423Z",
    "agent_auto_install_policy": "blocked",
    "manual_install_policy": "allowed_with_warning"
  },
  "content": {
    "user_title": "Write Safer Shell Scripts",
    "value_statement": "Shell scripts often fail because of quoting, error handling, and unclear input rules. This skill gives Claude, Codex, and Claude Code practical Bash and zsh patterns for safer automation.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "shell scripting",
      "bash scripting",
      "zsh scripting",
      "CLI automation",
      "shell best practices",
      "script debugging",
      "DevOps automation"
    ],
    "actual_capabilities": [
      "Provides a reusable Bash script template with strict mode, help output, and main function structure.",
      "Explains error handling with set options, cleanup traps, and explicit command failure checks.",
      "Shows safe variable expansion, arrays, associative arrays, conditionals, and loop patterns.",
      "Covers input prompts, file reading, output redirection, and common text processing tools.",
      "Lists practical do and do not guidance for quoting, ShellCheck, eval, and maintainable scripts."
    ],
    "limitations": [
      "It is documentation only and does not run ShellCheck or execute tests for generated scripts.",
      "Examples are focused on Bash and zsh, not fish, PowerShell, or Windows batch files.",
      "It does not include a full testing framework for shell scripts.",
      "One included awk example should be changed before publication because it reads /etc/passwd."
    ],
    "use_cases": [
      {
        "title": "Create reliable automation scripts",
        "description": "Use the template and strict-mode guidance to build scripts for repeated local or CI tasks.",
        "target_user": "DevOps engineers"
      },
      {
        "title": "Debug shell command failures",
        "description": "Apply the error handling and logging patterns to find where a script fails and why.",
        "target_user": "Software developers"
      },
      {
        "title": "Build small command-line tools",
        "description": "Use argument parsing, help output, and exit-code guidance to create simple team utilities.",
        "target_user": "Platform teams"
      }
    ],
    "prompt_templates": [
      {
        "title": "Begin a safe script",
        "scenario": "Beginner: create a new script skeleton.",
        "prompt": "Use the shell-scripting skill to draft a Bash script template for my task. Include strict mode, usage help, argument parsing, logging, and dry-run support."
      },
      {
        "title": "Improve an existing script",
        "scenario": "Intermediate: make a script more reliable.",
        "prompt": "Review this shell script with the shell-scripting skill. Focus on quoting, strict mode, cleanup traps, exit handling, and unsafe input assumptions."
      },
      {
        "title": "Automate file processing",
        "scenario": "Intermediate: process files or logs safely.",
        "prompt": "Use the shell-scripting skill to design a Bash workflow that processes these files. Show safe loops, input handling, output redirection, and clear failure behavior."
      },
      {
        "title": "Design a production CLI helper",
        "scenario": "Advanced: create a maintainable team tool.",
        "prompt": "Use the shell-scripting skill to plan a production-ready Bash CLI helper. Include subcommands, validation boundaries, logging, cleanup, test ideas, and ShellCheck considerations."
      }
    ],
    "output_examples": [
      {
        "input": "Create a Bash script for a weekly log cleanup job.",
        "output": "A structured script plan with strict mode, configurable paths, dry-run behavior, cleanup traps, and clear logging for deleted files."
      },
      {
        "input": "Review a deployment helper that fails silently.",
        "output": [
          "Add pipefail and undefined-variable checks.",
          "Quote path variables.",
          "Replace ignored command failures with explicit error messages.",
          "Add cleanup behavior for temporary files."
        ]
      },
      {
        "input": "Explain how to read a CSV file in shell safely.",
        "output": "A concise explanation of IFS, read -r, loop structure, quoted variables, and when to switch to a stronger CSV parser."
      }
    ],
    "best_practices": [
      "Ask for the target shell and operating system before generating commands that depend on platform behavior.",
      "Use dry-run mode for scripts that modify files, deployments, or system state.",
      "Run ShellCheck and a small test case before using generated scripts on real data."
    ],
    "anti_patterns": [
      "Do not paste generated destructive commands into a production shell without review and a dry run.",
      "Do not use eval or unquoted variables with user-controlled input.",
      "Do not treat short shell examples as complete security-reviewed production scripts."
    ],
    "faq": [
      {
        "question": "What shells does this skill cover?",
        "answer": "It focuses on Bash and zsh patterns, with most examples written in Bash syntax."
      },
      {
        "question": "Can it write complete scripts?",
        "answer": "Yes. It provides structure and patterns that Claude, Codex, or Claude Code can use to draft complete scripts."
      },
      {
        "question": "Does it execute shell commands?",
        "answer": "No. The skill is guidance text. Any command execution depends on the AI tool and user approval."
      },
      {
        "question": "Is it safe for production automation?",
        "answer": "It helps create safer scripts, but users should still review commands, run ShellCheck, test with sample data, and use dry-run mode."
      },
      {
        "question": "Does it teach text processing tools?",
        "answer": "Yes. It includes examples for find, grep, jq, awk, sed, redirection, and file-reading loops."
      },
      {
        "question": "What should be fixed before publication?",
        "answer": "The /etc/passwd awk example should be replaced with a harmless sample file to avoid teaching sensitive file access."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 357
    }
  ]
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall