Skip to content

aiskillstore/marketplace / skills/0xdarkmatter/find-replace

find-replace

Verified

Modern find-and-replace using sd (simpler than sed) and batch replacement patterns. Triggers on: sd, find replace, batch replace, sed replacement, string replacement, rename.

FileKindSize
SKILL.mdskill md2.1 KB
assets/.gitkeepother0 B
references/advanced-patterns.mdmarkdown5.4 KB
scripts/.gitkeepother0 B
skill-report.jsonconfig41.4 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T13:01:44.111Z",
    "slug": "0xdarkmatter-find-replace",
    "source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/find-replace",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "3161f3c78fa1de550a785b7b8f983b9e9437ab802380bb944301911e559bf38c",
    "tree_hash": "ade459c954f31ae7b9568bf9ea74bf1554306c749573b8a1ce081d151c92e6c6",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "find-replace",
    "description": "Use sd with rg, fd, and git workflows to preview and apply find-and-replace changes across codebases.",
    "summary": "Guides safe text replacement, regex matching, and batch edits with the sd command-line tool.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "0xDarkMatter",
    "license": "MIT",
    "tags": [
      "find-replace",
      "sd",
      "regex",
      "refactoring",
      "batch-editing"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "env_access",
      "filesystem"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "high",
    "is_blocked": false,
    "safe_to_publish": false,
    "analysis_status": "ok",
    "summary": "Most static detections are false positives caused by Markdown code fences, inline command examples, or benign regex guidance. I confirmed the unquoted command-substitution workflows and the .env replacement example because they can affect sensitive files or mis-handle unsafe filenames. No prompt injection, credential exfiltration intent, or hidden malicious behavior was found.",
    "remediation": [
      {
        "issue": "Unquoted command substitution is used to pass file lists into sd.",
        "suggestion": "Prefer fd -x, xargs -0, or another null-delimited workflow, and quote every path passed to sd.",
        "severity": "medium"
      },
      {
        "issue": "The advanced configuration example edits .env* files.",
        "suggestion": "Add an explicit warning and require user confirmation before changing environment files or secret-bearing configuration.",
        "severity": "high"
      },
      {
        "issue": "The Docker example mounts the workspace and runs sh -c inside a container.",
        "suggestion": "Mark the Docker workflow as optional, require confirmation, and pin any image or package versions used in examples.",
        "severity": "medium"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 149,
            "line_end": 149
          },
          {
            "file": "references/advanced-patterns.md",
            "line_start": 184,
            "line_end": 184
          },
          {
            "file": "references/advanced-patterns.md",
            "line_start": 228,
            "line_end": 228
          },
          {
            "file": "references/advanced-patterns.md",
            "line_start": 231,
            "line_end": 231
          },
          {
            "file": "references/advanced-patterns.md",
            "line_start": 234,
            "line_end": 234
          },
          {
            "file": "references/advanced-patterns.md",
            "line_start": 244,
            "line_end": 244
          },
          {
            "file": "references/advanced-patterns.md",
            "line_start": 183,
            "line_end": 183
          },
          {
            "file": "SKILL.md",
            "line_start": 17,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 32,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 33,
            "line_end": 33
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 40,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 52,
            "line_end": 56
          },
          {
            "file": "SKILL.md",
            "line_start": 56,
            "line_end": 69
          },
          {
            "file": "SKILL.md",
            "line_start": 69,
            "line_end": 75
          },
          {
            "file": "SKILL.md",
            "line_start": 75,
            "line_end": 75
          },
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 76
          },
          {
            "file": "SKILL.md",
            "line_start": 77,
            "line_end": 77
          },
          {
            "file": "SKILL.md",
            "line_start": 78,
            "line_end": 78
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 85,
            "line_end": 87
          },
          {
            "file": "SKILL.md",
            "line_start": 87,
            "line_end": 93
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 56,
            "line_end": 69
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 85,
            "line_end": 85
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 48
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:references/advanced-patterns.md:149:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-patterns.md",
        "line_start": 149,
        "line_end": 149,
        "snippet": "sd 'oldPattern' 'newPattern' $(rg -l 'oldPattern' src/)"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:184:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-patterns.md",
        "line_start": 184,
        "line_end": 184,
        "snippet": "files=$(rg -l 'oldApi' src/)"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:228:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-patterns.md",
        "line_start": 228,
        "line_end": 228,
        "snippet": "sd 'old' 'new' $(git diff --name-only)"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:231:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-patterns.md",
        "line_start": 231,
        "line_end": 231,
        "snippet": "sd 'old' 'new' $(git diff --cached --name-only)"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:234:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-patterns.md",
        "line_start": 234,
        "line_end": 234,
        "snippet": "sd 'old' 'new' $(git diff-tree --no-commit-id --name-only -r HEAD)"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:244:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-patterns.md",
        "line_start": 244,
        "line_end": 244,
        "snippet": "docker run -v $(pwd):/data alpine sh -c \"apk add sd && sd 'old' 'new' /data/file.txt\""
      },
      {
        "id": "external_commands:references/advanced-patterns.md:183:unix-shell-invocation",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Unix shell invocation",
        "file": "references/advanced-patterns.md",
        "line_start": 183,
        "line_end": 183,
        "snippet": "#!/bin/bash"
      },
      {
        "id": "env_access:references/advanced-patterns.md:85:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "references/advanced-patterns.md",
        "line_start": 85,
        "line_end": 85,
        "snippet": "sd 'DATABASE_URL' 'DB_CONNECTION_STRING' .env* src/**/*.ts"
      },
      {
        "id": "sensitive:references/advanced-patterns.md:85:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/advanced-patterns.md",
        "line_start": 85,
        "line_end": 85,
        "snippet": "sd 'DATABASE_URL' 'DB_CONNECTION_STRING' .env* src/**/*.ts"
      },
      {
        "id": "blocker:references/advanced-patterns.md:234:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/advanced-patterns.md",
        "line_start": 234,
        "line_end": 234,
        "snippet": "sd 'old' 'new' $(git diff-tree --no-commit-id --name-only -r HEAD)"
      },
      {
        "id": "blocker:references/advanced-patterns.md:254:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/advanced-patterns.md",
        "line_start": 254,
        "line_end": 254,
        "snippet": "| Use `\\b` for word boundaries | Avoid partial matches |"
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 17,
        "line_end": 26,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 32,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 32,
        "line_end": 32,
        "snippet": "| `sed 's/old/new/g'` | `sd 'old' 'new'` |"
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 33,
        "line_end": 33,
        "snippet": "| `sed -i 's/old/new/g'` | `sd 'old' 'new' file` |"
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 34,
        "snippet": "| `sed 's#path/to#new/path#g'` | `sd 'path/to' 'new/path'` |"
      },
      {
        "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": 52,
        "snippet": "```bash"
      },
      {
        "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": 56,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 56,
        "line_end": 69,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 69,
        "line_end": 75,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 75,
        "line_end": 75,
        "snippet": "| `.` | `\\.` |"
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 76,
        "line_end": 76,
        "snippet": "| `*` | `\\*` |"
      },
      {
        "id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 77,
        "line_end": 77,
        "snippet": "| `[` `]` | `\\[` `\\]` |"
      },
      {
        "id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 78,
        "line_end": 78,
        "snippet": "| `$` | `\\$` |"
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 79,
        "line_end": 79,
        "snippet": "| `\\` | `\\\\` |"
      },
      {
        "id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 85,
        "line_end": 87,
        "snippet": "| Always preview with `rg -r` first | Avoid mistakes |"
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 87,
        "line_end": 93,
        "snippet": "| Use `\\b` for word boundaries | Avoid partial matches |"
      },
      {
        "id": "external_commands:SKILL.md:64:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "SKILL.md",
        "line_start": 64,
        "line_end": 64,
        "snippet": "sd 'oldPattern' 'newPattern' $(rg -l 'oldPattern' src/)"
      },
      {
        "id": "external_commands:SKILL.md:56:template-literal-with-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Template literal with command substitution",
        "file": "SKILL.md",
        "line_start": 56,
        "line_end": 69,
        "snippet": "```bash"
      },
      {
        "id": "filesystem:SKILL.md:48:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "sd \"from '../utils'\" \"from '@/utils'\" src/**/*.ts"
      },
      {
        "id": "blocker:SKILL.md:44:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 44,
        "line_end": 44,
        "snippet": "# Word boundaries (avoid partial matches)"
      },
      {
        "id": "blocker:SKILL.md:85:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 85,
        "line_end": 85,
        "snippet": "| Always preview with `rg -r` first | Avoid mistakes |"
      },
      {
        "id": "blocker:SKILL.md:87:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 87,
        "line_end": 87,
        "snippet": "| Use `\\b` for word boundaries | Avoid partial matches |"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:references/advanced-patterns.md:149:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.58,
        "reason": "The example expands a file list with command substitution before running sd. This can mis-handle filenames with whitespace or leading dashes if an agent runs it automatically.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:184:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.6,
        "reason": "The shell script stores rg output in a variable and iterates with word splitting. It is a legitimate batch-edit example, but unsafe file names can change command behavior.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:228:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.57,
        "reason": "The example feeds git output through unquoted command substitution into sd. Changed file names with spaces or option-like names can be split or interpreted incorrectly.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:231:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.57,
        "reason": "The staged-file example uses unquoted command substitution. It is common git tooling, but it can target the wrong files when filenames contain shell-sensitive characters.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:234:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.56,
        "reason": "The last-commit example expands git output directly into sd arguments. This is not malicious, but it is an unsafe shell pattern for arbitrary repository filenames.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:244:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.72,
        "reason": "The Docker example mounts the current directory and runs a shell command that installs software before editing a mounted file. This is a real execution and workspace-modification risk if automated.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-patterns.md:183:unix-shell-invocation",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line is a shebang inside a documentation example for a local batch script. It does not instruct hidden execution or invoke a shell by itself."
      },
      {
        "id": "env_access:references/advanced-patterns.md:85:database-connection-strings",
        "verdict": "confirmed",
        "confidence": 0.64,
        "reason": "The command targets .env* files while renaming DATABASE_URL. This is a legitimate configuration example, but it touches files that commonly contain secrets and can corrupt sensitive settings.",
        "severity": "high"
      },
      {
        "id": "sensitive:references/advanced-patterns.md:85:environment-file-access",
        "verdict": "confirmed",
        "confidence": 0.66,
        "reason": "The example directly includes .env* in the replacement targets. Even without exfiltration, automated edits to environment files are sensitive and need explicit user confirmation.",
        "severity": "high"
      },
      {
        "id": "blocker:references/advanced-patterns.md:234:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "git diff-tree is used to select files changed in the last commit for replacement. This is repository-scoped file selection, not system reconnaissance."
      },
      {
        "id": "blocker:references/advanced-patterns.md:254:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The line is a best-practice table entry about regex word boundaries. It has no system inspection or reconnaissance behavior."
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown bash code fence, not Ruby backtick execution. The surrounding examples document sd usage rather than executing code inside the skill file."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is the closing Markdown fence for a command example. It is formatting, not a runtime shell execution primitive."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "This is an inline Markdown table comparing sed and sd syntax. The backticks are documentation formatting, not executable Ruby or shell substitution."
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "This row documents equivalent sed and sd commands. Inline code formatting in Markdown does not create command execution by itself."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The line is a static syntax comparison in a Markdown table. It does not contain an execution sink or hidden automation."
      },
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown code-fence marker. The actual commands are visible documentation examples, not embedded Ruby backtick execution."
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text closes a Markdown code block. It has no runtime behavior and is not an execution primitive."
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This points at a Markdown bash fence, not Ruby shell backticks. The risky command substitution inside this block is covered by the separate line 64 finding."
      },
      {
        "id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched line is only the closing Markdown fence for the safe workflow block. It does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This is an inline Markdown table entry showing how to escape a period in regex. It is documentation formatting, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This is an inline Markdown table entry showing how to escape an asterisk. It does not invoke a shell or execute code."
      },
      {
        "id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The line documents regex escaping for brackets using inline code formatting. There is no executable backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The line documents escaping a dollar sign in regex. Markdown inline code is not command substitution in this context."
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The line documents escaping a backslash. It is a static reference table, not an executable instruction beyond normal regex guidance."
      },
      {
        "id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The line recommends previewing replacements with rg -r. Inline Markdown backticks are used for tool names and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The line documents regex word boundaries in inline Markdown code. It has no shell execution behavior."
      },
      {
        "id": "external_commands:SKILL.md:64:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.59,
        "reason": "The core workflow applies sd to files returned by unquoted rg command substitution. This can mis-handle arbitrary filenames and should use safer file selection.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:56:template-literal-with-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "The reported location is the Markdown fence that starts the workflow example. The concrete command-substitution risk in the block is already represented by the SKILL.md line 64 finding."
      },
      {
        "id": "filesystem:SKILL.md:48:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The ../utils text is a quoted import string being replaced inside source files. It is not used as a filesystem traversal path by the skill itself."
      },
      {
        "id": "blocker:SKILL.md:44:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The line is a heading comment about regex word boundaries. It does not inspect the system or enumerate host details."
      },
      {
        "id": "blocker:SKILL.md:85:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The line recommends previewing replacements with rg. That is scoped to user-selected project files and is not system reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:87:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The line describes regex word boundaries as a safety tip. It contains no reconnaissance instruction or host inspection behavior."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Database connection strings",
        "description": "sd 'DATABASE_URL' 'DB_CONNECTION_STRING' .env* src/**/*.ts",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 85,
            "line_end": 85
          }
        ],
        "review_kind": "capability",
        "source_category": "env_access",
        "source_severity": "high",
        "confidence": 0.64,
        "confidence_reasoning": "The command targets .env* files while renaming DATABASE_URL. This is a legitimate configuration example, but it touches files that commonly contain secrets and can corrupt sensitive settings."
      },
      {
        "title": "Environment file access",
        "description": "sd 'DATABASE_URL' 'DB_CONNECTION_STRING' .env* src/**/*.ts",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 85,
            "line_end": 85
          }
        ],
        "review_kind": "security",
        "source_category": "sensitive",
        "source_severity": "high",
        "confidence": 0.66,
        "confidence_reasoning": "The example directly includes .env* in the replacement targets. Even without exfiltration, automated edits to environment files are sensitive and need explicit user confirmation."
      }
    ],
    "medium_findings": [
      {
        "title": "Shell command substitution",
        "description": "sd 'oldPattern' 'newPattern' $(rg -l 'oldPattern' src/)",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 149,
            "line_end": 149
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.58,
        "confidence_reasoning": "The example expands a file list with command substitution before running sd. This can mis-handle filenames with whitespace or leading dashes if an agent runs it automatically."
      },
      {
        "title": "Shell command substitution",
        "description": "files=$(rg -l 'oldApi' src/)",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 184,
            "line_end": 184
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.6,
        "confidence_reasoning": "The shell script stores rg output in a variable and iterates with word splitting. It is a legitimate batch-edit example, but unsafe file names can change command behavior."
      },
      {
        "title": "Shell command substitution",
        "description": "sd 'old' 'new' $(git diff --name-only)",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 228,
            "line_end": 228
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.57,
        "confidence_reasoning": "The example feeds git output through unquoted command substitution into sd. Changed file names with spaces or option-like names can be split or interpreted incorrectly."
      },
      {
        "title": "Shell command substitution",
        "description": "sd 'old' 'new' $(git diff --cached --name-only)",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 231,
            "line_end": 231
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.57,
        "confidence_reasoning": "The staged-file example uses unquoted command substitution. It is common git tooling, but it can target the wrong files when filenames contain shell-sensitive characters."
      },
      {
        "title": "Shell command substitution",
        "description": "sd 'old' 'new' $(git diff-tree --no-commit-id --name-only -r HEAD)",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 234,
            "line_end": 234
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.56,
        "confidence_reasoning": "The last-commit example expands git output directly into sd arguments. This is not malicious, but it is an unsafe shell pattern for arbitrary repository filenames."
      },
      {
        "title": "Shell command substitution",
        "description": "docker run -v $(pwd):/data alpine sh -c \"apk add sd && sd 'old' 'new' /data/file.txt\"",
        "locations": [
          {
            "file": "references/advanced-patterns.md",
            "line_start": 244,
            "line_end": 244
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.72,
        "confidence_reasoning": "The Docker example mounts the current directory and runs a shell command that installs software before editing a mounted file. This is a real execution and workspace-modification risk if automated."
      },
      {
        "title": "Shell command substitution",
        "description": "sd 'oldPattern' 'newPattern' $(rg -l 'oldPattern' src/)",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 64
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.59,
        "confidence_reasoning": "The core workflow applies sd to files returned by unquoted rg command substitution. This can mis-handle arbitrary filenames and should use safer file selection."
      }
    ],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 4,
    "total_lines": 354,
    "audit_model": "codex",
    "audited_at": "2026-07-04T13:01:44.111Z",
    "agent_auto_install_policy": "confirmation_required",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Replace Text Safely Across Codebases",
    "value_statement": "Large codebases make repeated text changes slow and error-prone. This skill guides sd-based replacements with previews, regex patterns, and batch workflows.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "sd find replace",
      "regex replacement",
      "batch refactoring",
      "ripgrep preview",
      "sed alternative",
      "codebase text replacement",
      "developer productivity"
    ],
    "actual_capabilities": [
      "Explains basic sd syntax for replacing text in one file or many files.",
      "Shows how to preview replacements before writing changes.",
      "Maps common sed commands to simpler sd equivalents.",
      "Documents regex capture groups, word boundaries, and escaping rules.",
      "Provides batch workflows using rg, fd, git file lists, and Docker examples.",
      "Includes examples for imports, API paths, configuration keys, and React files."
    ],
    "limitations": [
      "Requires the sd command-line tool to be installed and available in the shell.",
      "In-place replacements can damage files when patterns are too broad.",
      "Regex accuracy depends on the user-supplied search and replacement patterns.",
      "Rollback is not automated beyond normal git review and restore workflows."
    ],
    "use_cases": [
      {
        "title": "Rename Symbols Across a Project",
        "description": "Replace old variable, function, or component names while previewing affected files first.",
        "target_user": "Software developers"
      },
      {
        "title": "Update Imports During Refactors",
        "description": "Convert relative imports, reorganize named imports, or change module paths across TypeScript files.",
        "target_user": "Frontend engineers"
      },
      {
        "title": "Modernize Repeated Text Patterns",
        "description": "Apply repeatable replacements for API paths, configuration names, logging calls, and JSX attributes.",
        "target_user": "Maintainers and migration leads"
      }
    ],
    "prompt_templates": [
      {
        "title": "Preview a Simple Replacement",
        "scenario": "Beginner replacement in one area of a project.",
        "prompt": "Use the find-replace skill to preview replacing oldName with newName under src. Do not modify files yet."
      },
      {
        "title": "Apply a Reviewed Replacement",
        "scenario": "User has reviewed the preview and wants a controlled edit.",
        "prompt": "Use sd to replace oldName with newName in matching TypeScript files. Show the changed files and summarize the diff."
      },
      {
        "title": "Refactor Import Paths",
        "scenario": "Project import paths need a consistent alias.",
        "prompt": "Find imports that use ../utils and replace them with @/utils. Preview matches first, then apply only after confirmation."
      },
      {
        "title": "Plan a Batch Migration",
        "scenario": "Advanced multi-step migration with several patterns.",
        "prompt": "Create a safe batch replacement plan for renaming oldApi methods to newApi methods. Include preview, apply, verify, and rollback steps."
      }
    ],
    "output_examples": [
      {
        "input": "Preview replacing a deprecated function name across source files.",
        "output": "The assistant lists likely matches, explains the replacement scope, and asks before applying in-place edits."
      },
      {
        "input": "Change import paths from a relative utility folder to a project alias.",
        "output": "The assistant previews affected import statements, applies the replacement after approval, and summarizes changed files."
      },
      {
        "input": "Plan several API method renames during a migration.",
        "output": "The assistant groups replacements by method, recommends a safe execution order, and includes verification with search and diff review."
      }
    ],
    "best_practices": [
      "Preview every replacement before modifying files.",
      "Use narrow paths and word boundaries to avoid unintended matches.",
      "Review git diff after each batch before starting another batch."
    ],
    "anti_patterns": [
      "Do not run broad replacements across the repository without a preview.",
      "Do not edit secret-bearing files unless the user explicitly requests it.",
      "Do not rely on unquoted shell-expanded file lists for unknown repositories."
    ],
    "faq": [
      {
        "question": "What tool does this skill use?",
        "answer": "It uses sd, a command-line replacement tool designed to be simpler than sed for many common edits."
      },
      {
        "question": "Does it modify files automatically?",
        "answer": "The examples include in-place edits, but a safe workflow previews matches and asks before applying changes."
      },
      {
        "question": "Can it replace text across many files?",
        "answer": "Yes. It shows batch workflows with rg, fd, git file lists, and scoped glob patterns."
      },
      {
        "question": "Can it handle regular expressions?",
        "answer": "Yes. It documents capture groups, word boundaries, multiline patterns, and escaping for special characters."
      },
      {
        "question": "Is this a full refactoring engine?",
        "answer": "No. It performs text and regex replacement, so users must verify syntax and behavior after changes."
      },
      {
        "question": "Which assistants can use this skill?",
        "answer": "The report lists support for Claude, Codex, and Claude Code."
      }
    ]
  },
  "file_structure": [
    {
      "name": "assets",
      "type": "dir",
      "path": "assets",
      "children": [
        {
          "name": ".gitkeep",
          "type": "file",
          "path": "assets/.gitkeep",
          "lines": 0
        }
      ]
    },
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "advanced-patterns.md",
          "type": "file",
          "path": "references/advanced-patterns.md",
          "lines": 258
        }
      ]
    },
    {
      "name": "scripts",
      "type": "dir",
      "path": "scripts",
      "children": [
        {
          "name": ".gitkeep",
          "type": "file",
          "path": "scripts/.gitkeep",
          "lines": 0
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 94
    }
  ]
}
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