Skip to content

aiskillstore/marketplace / skills/0xdarkmatter/file-search

file-search

Verified

Modern file and content search using fd, ripgrep (rg), and fzf. Triggers on: fd, ripgrep, rg, find files, search code, fzf, fuzzy find, search codebase.

FileKindSize
SKILL.mdskill md2.3 KB
assets/.gitkeepother0 B
references/advanced-workflows.mdmarkdown7.8 KB
scripts/.gitkeepother0 B
skill-report.jsonconfig48.7 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T12:56:11.072Z",
    "slug": "0xdarkmatter-file-search",
    "source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/file-search",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "43cddbf3b4a55bbad476c75dedbe918369023adc2be4e9d86d82705e025b039d",
    "tree_hash": "b6c35b1527c91d455dafdbfc8e7460112eed7dc35034eb17fc8f1d4ffe53abd0",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "file-search",
    "description": "Modern file and content search workflows using fd, ripgrep, and fzf for codebase navigation.",
    "summary": "Find files, search code, and build interactive terminal search workflows with fd, ripgrep, and fzf.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "0xDarkMatter",
    "license": "MIT",
    "tags": [
      "file-search",
      "ripgrep",
      "fd",
      "fzf",
      "code-navigation"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "scripts",
      "external_commands"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "medium",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "Most static findings are markdown examples or safe command documentation, including false positives from fenced code blocks. Confirmed risks are limited to destructive or broad file-changing shell workflows, and no prompt injection or data exfiltration evidence was found.",
    "remediation": [
      {
        "issue": "Destructive deletion examples use xargs with rm.",
        "suggestion": "Add explicit warnings, dry-run steps, and confirmation requirements before deletion workflows. Prefer null-delimited pipelines for file names.",
        "severity": "medium"
      },
      {
        "issue": "Batch write and rename examples lack safety guardrails.",
        "suggestion": "Require previews, git status checks, backups, or user approval before running write, rename, or formatting commands.",
        "severity": "medium"
      },
      {
        "issue": "Some shell pipelines use command substitution or plain xargs with file paths.",
        "suggestion": "Document quoting rules and safer alternatives such as arrays, --print0, and xargs -0 for paths with spaces or newlines.",
        "severity": "low"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "scripts",
        "evidence": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 233,
            "line_end": 233
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 87,
            "line_end": 87
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 234,
            "line_end": 234
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 235,
            "line_end": 235
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 250,
            "line_end": 250
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 256,
            "line_end": 256
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 262,
            "line_end": 262
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 264,
            "line_end": 264
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 265,
            "line_end": 265
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 153,
            "line_end": 153
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 154,
            "line_end": 154
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 158,
            "line_end": 158
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 176,
            "line_end": 176
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 197,
            "line_end": 197
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 207,
            "line_end": 207
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 210,
            "line_end": 210
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 213,
            "line_end": 213
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 216,
            "line_end": 216
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 273,
            "line_end": 273
          },
          {
            "file": "SKILL.md",
            "line_start": 17,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 32,
            "line_end": 36
          },
          {
            "file": "SKILL.md",
            "line_start": 36,
            "line_end": 51
          },
          {
            "file": "SKILL.md",
            "line_start": 51,
            "line_end": 55
          },
          {
            "file": "SKILL.md",
            "line_start": 55,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 74
          },
          {
            "file": "SKILL.md",
            "line_start": 74,
            "line_end": 80
          },
          {
            "file": "SKILL.md",
            "line_start": 80,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 83
          },
          {
            "file": "SKILL.md",
            "line_start": 83,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 85
          },
          {
            "file": "SKILL.md",
            "line_start": 85,
            "line_end": 86
          },
          {
            "file": "SKILL.md",
            "line_start": 86,
            "line_end": 87
          },
          {
            "file": "SKILL.md",
            "line_start": 87,
            "line_end": 93
          },
          {
            "file": "SKILL.md",
            "line_start": 93,
            "line_end": 94
          },
          {
            "file": "SKILL.md",
            "line_start": 94,
            "line_end": 94
          },
          {
            "file": "SKILL.md",
            "line_start": 95,
            "line_end": 96
          },
          {
            "file": "SKILL.md",
            "line_start": 96,
            "line_end": 101
          },
          {
            "file": "SKILL.md",
            "line_start": 63,
            "line_end": 63
          },
          {
            "file": "SKILL.md",
            "line_start": 73,
            "line_end": 73
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "scripts:references/advanced-workflows.md:233:dynamic-import-expression",
        "category": "scripts",
        "severity": "medium",
        "pattern": "Dynamic import() expression",
        "file": "references/advanced-workflows.md",
        "line_start": 233,
        "line_end": 233,
        "snippet": "rg \"^import (\\w+)\" -o -r '$1' | sort -u > imports.txt"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:87:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 87,
        "line_end": 87,
        "snippet": "sd \"old_function\" \"new_function\" $(rg -l \"old_function\")"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:234:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 234,
        "line_end": 234,
        "snippet": "for imp in $(cat imports.txt); do"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:235:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 235,
        "line_end": 235,
        "snippet": "count=$(rg \"\\b$imp\\b\" | wc -l)"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:250:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 250,
        "line_end": 250,
        "snippet": "dir=$(fd -t d | fzf --preview 'eza --tree --level=2 {}') && cd \"$dir\""
      },
      {
        "id": "external_commands:references/advanced-workflows.md:256:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 256,
        "line_end": 256,
        "snippet": "file=$(fd -t f | fzf --preview 'bat --color=always {}') && ${EDITOR:-vim} \"$file\""
      },
      {
        "id": "external_commands:references/advanced-workflows.md:262:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 262,
        "line_end": 262,
        "snippet": "result=$(rg -n \"\" | fzf --preview 'bat {1} -H {2}')"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:264:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 264,
        "line_end": 264,
        "snippet": "local file=$(echo \"$result\" | cut -d: -f1)"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:265:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/advanced-workflows.md",
        "line_start": 265,
        "line_end": 265,
        "snippet": "local line=$(echo \"$result\" | cut -d: -f2)"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:153:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 153,
        "line_end": 153,
        "snippet": "fd | fzf -m | xargs rm -i               # Delete selected"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:154:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 154,
        "line_end": 154,
        "snippet": "fd -e ts | fzf -m | xargs code          # Open selected in VS Code"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:158:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 158,
        "line_end": 158,
        "snippet": "xargs -p rm"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:176:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 176,
        "line_end": 176,
        "snippet": "rg -n \"pattern\" | fzf | awk -F: '{print \"+\" $2, $1}' | xargs nvim"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:197:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 197,
        "line_end": 197,
        "snippet": "fd -e ts | rg -l \"deprecated\" | fzf -m | xargs rm"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:207:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 207,
        "line_end": 207,
        "snippet": "git status -s | fzf -m | awk '{print $2}' | xargs git add"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:210:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 210,
        "line_end": 210,
        "snippet": "git branch | fzf | xargs git checkout"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:213:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 213,
        "line_end": 213,
        "snippet": "git log --oneline | fzf | awk '{print $1}' | xargs git cherry-pick"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:216:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 216,
        "line_end": 216,
        "snippet": "git log --oneline | fzf -m | tail -1 | awk '{print $1}' | xargs git rebase -i"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:273:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "references/advanced-workflows.md",
        "line_start": 273,
        "line_end": 273,
        "snippet": "awk '{print $2}' | xargs git add"
      },
      {
        "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": 32,
        "snippet": "```bash"
      },
      {
        "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": 36,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 36,
        "line_end": 51,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 51,
        "line_end": 55,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 55,
        "line_end": 64,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 64,
        "line_end": 68,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 74,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 74,
        "line_end": 80,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 80,
        "line_end": 81,
        "snippet": "| Find TS files | `fd -e ts` |"
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 81,
        "line_end": 82,
        "snippet": "| Find in src | `fd -e ts src/` |"
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 82,
        "line_end": 83,
        "snippet": "| Search pattern | `rg \"pattern\"` |"
      },
      {
        "id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 83,
        "line_end": 84,
        "snippet": "| Search in type | `rg -t py \"import\"` |"
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 84,
        "line_end": 85,
        "snippet": "| Files with match | `rg -l \"pattern\"` |"
      },
      {
        "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": 86,
        "snippet": "| Count matches | `rg -c \"pattern\"` |"
      },
      {
        "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": 87,
        "snippet": "| Interactive | `fd \\| fzf` |"
      },
      {
        "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": "| With preview | `fd \\| fzf --preview 'bat {}'` |"
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 93,
        "line_end": 94,
        "snippet": "| Both respect `.gitignore` | Auto-skip node_modules, dist |"
      },
      {
        "id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 94,
        "line_end": 94,
        "snippet": "| Use `-t` over `-g` | Type flags are faster |"
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 95,
        "line_end": 96,
        "snippet": "| Narrow the path | `rg pattern src/` faster |"
      },
      {
        "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": 101,
        "snippet": "| Use `-F` for literals | Avoids regex overhead |"
      },
      {
        "id": "external_commands:SKILL.md:63:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "SKILL.md",
        "line_start": 63,
        "line_end": 63,
        "snippet": "fd -e ts | fzf -m | xargs code"
      },
      {
        "id": "external_commands:SKILL.md:73:xargs-command-can-execute-arbitrary-commands",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "xargs command (can execute arbitrary commands)",
        "file": "SKILL.md",
        "line_start": 73,
        "line_end": 73,
        "snippet": "rg -l \"pattern\" | fzf --preview 'rg -C 3 \"pattern\" {}' | xargs vim"
      }
    ],
    "finding_verdicts": [
      {
        "id": "scripts:references/advanced-workflows.md:233:dynamic-import-expression",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The text is a ripgrep pattern searching for import statements and writing names to imports.txt. It is not JavaScript dynamic import() or executable script loading."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:87:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.78,
        "reason": "This replacement example writes changes to every file returned by rg and uses unquoted command substitution. It can modify unintended files when paths contain spaces or special characters.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:234:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The command substitution reads the local imports.txt file produced by the previous example and iterates over words. It does not turn file content into a command."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:235:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The substitution captures a numeric count from rg and wc. The import name comes from a word-character regex, so this is not command injection."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:250:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "This shell function captures a directory selected by fd and fzf, then quotes it before cd. It is an interactive navigation helper, not hidden command execution."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:256:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "This captures a user-selected file and opens it with the configured editor using a quoted file argument. It is an expected interactive edit workflow."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:262:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "The substitution stores a selected search result from rg and fzf for later parsing. It does not execute the selected text as shell code."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:264:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This line extracts the file component from an already captured result using echo and cut. It performs string parsing only and does not execute user-controlled commands."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:265:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This line extracts the line-number component from an already captured result using echo and cut. It is parsing output, not executing arbitrary input."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:153:xargs-command-can-execute-arbitrary-commands",
        "verdict": "confirmed",
        "confidence": 0.9,
        "reason": "The pipeline sends interactive fzf selections to rm -i, which is a real deletion workflow. The confirmation flag reduces risk but it can still remove project files if executed.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:154:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "xargs passes selected TypeScript file paths to the hardcoded code editor command. It opens files and does not execute arbitrary commands from the input."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:158:xargs-command-can-execute-arbitrary-commands",
        "verdict": "confirmed",
        "confidence": 0.88,
        "reason": "This example pipes selected file paths into rm through xargs. xargs -p asks before execution, but the documented action is still file deletion.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:176:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The pipeline converts a selected ripgrep result into nvim arguments for opening a file at a line. The command is hardcoded and does not evaluate input as shell code."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:197:xargs-command-can-execute-arbitrary-commands",
        "verdict": "confirmed",
        "confidence": 0.93,
        "reason": "This workflow deletes selected TypeScript files with xargs rm and has no confirmation flag. It is a destructive command that could remove repository files.",
        "severity": "medium"
      },
      {
        "id": "external_commands:references/advanced-workflows.md:207:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "This uses xargs to pass selected git status paths to git add. It mutates the git index, but the command is hardcoded and not arbitrary execution."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:210:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.76,
        "reason": "This passes a selected branch name to git checkout through a hardcoded command. It can change the working tree, but it is not command injection."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:213:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.76,
        "reason": "This passes a selected commit hash to git cherry-pick through a hardcoded command. It changes repository state but does not execute selected text as a command."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:216:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.74,
        "reason": "This passes a selected commit hash to git rebase -i through a hardcoded command. It is a risky git operation, but not arbitrary command execution."
      },
      {
        "id": "external_commands:references/advanced-workflows.md:273:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "This passes selected git status paths to git add after an fzf preview. The command is hardcoded and stages files rather than executing input."
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a markdown fenced code block delimiter around shell examples. It is not Ruby backtick execution and is not evaluated by the skill."
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline markdown documentation in a reference table, not Ruby backtick execution. The backticks format command text and are not executed."
      },
      {
        "id": "external_commands:SKILL.md:63:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "This example sends selected TypeScript files to the hardcoded code editor command. It is an interactive open workflow, not arbitrary command execution."
      },
      {
        "id": "external_commands:SKILL.md:73:xargs-command-can-execute-arbitrary-commands",
        "verdict": "false_positive",
        "confidence": 0.8,
        "reason": "This example sends selected matching files to vim through a hardcoded command. It opens files for review and does not evaluate input as shell code."
      }
    ],
    "semantic_findings": [
      {
        "title": "Unqualified Batch File Modification Guidance",
        "description": "The advanced workflows include batch formatting and rename operations without requiring previews, backups, or confirmation. An AI agent could apply broad repository changes if it follows them directly.",
        "severity": "medium",
        "locations": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 12,
            "line_end": 20
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 188,
            "line_end": 190
          }
        ],
        "confidence": 0.86,
        "confidence_reasoning": "The cited examples use write and rename operations that can change many files. They are legitimate workflows, but the surrounding guidance does not require a dry run or explicit confirmation."
      }
    ],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [
      {
        "title": "Shell command substitution",
        "description": "sd \"old_function\" \"new_function\" $(rg -l \"old_function\")",
        "locations": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 87,
            "line_end": 87
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.78,
        "confidence_reasoning": "This replacement example writes changes to every file returned by rg and uses unquoted command substitution. It can modify unintended files when paths contain spaces or special characters."
      },
      {
        "title": "xargs command (can execute arbitrary commands)",
        "description": "fd | fzf -m | xargs rm -i               # Delete selected",
        "locations": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 153,
            "line_end": 153
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.9,
        "confidence_reasoning": "The pipeline sends interactive fzf selections to rm -i, which is a real deletion workflow. The confirmation flag reduces risk but it can still remove project files if executed."
      },
      {
        "title": "xargs command (can execute arbitrary commands)",
        "description": "xargs -p rm",
        "locations": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 158,
            "line_end": 158
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.88,
        "confidence_reasoning": "This example pipes selected file paths into rm through xargs. xargs -p asks before execution, but the documented action is still file deletion."
      },
      {
        "title": "xargs command (can execute arbitrary commands)",
        "description": "fd -e ts | rg -l \"deprecated\" | fzf -m | xargs rm",
        "locations": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 197,
            "line_end": 197
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.93,
        "confidence_reasoning": "This workflow deletes selected TypeScript files with xargs rm and has no confirmation flag. It is a destructive command that could remove repository files."
      },
      {
        "title": "Unqualified Batch File Modification Guidance",
        "description": "The advanced workflows include batch formatting and rename operations without requiring previews, backups, or confirmation. An AI agent could apply broad repository changes if it follows them directly.",
        "locations": [
          {
            "file": "references/advanced-workflows.md",
            "line_start": 12,
            "line_end": 20
          },
          {
            "file": "references/advanced-workflows.md",
            "line_start": 188,
            "line_end": 190
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "medium",
        "confidence": 0.86,
        "confidence_reasoning": "The cited examples use write and rename operations that can change many files. They are legitimate workflows, but the surrounding guidance does not require a dry run or explicit confirmation."
      }
    ],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 4,
    "total_lines": 419,
    "audit_model": "codex",
    "audited_at": "2026-07-04T12:56:11.072Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Find Files and Search Code Faster",
    "value_statement": "Large codebases make file and text search slow. This skill provides fd, ripgrep, and fzf workflows for precise discovery and navigation.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "file search",
      "ripgrep",
      "fd command",
      "fzf",
      "code search",
      "repository navigation",
      "terminal workflows"
    ],
    "actual_capabilities": [
      "Provides fd recipes for name, type, extension, size, time, and path filtered file discovery.",
      "Shows ripgrep patterns for content search, context output, counts, replacement previews, and multiline matching.",
      "Combines fd, rg, and fzf for interactive file selection, previews, and editor navigation.",
      "Includes git workflows for staging, branch checkout, diff preview, cherry-pick, and interactive rebase selection.",
      "Documents shell functions for changing directories, opening files, and jumping to search results."
    ],
    "limitations": [
      "Requires fd and ripgrep, and fzf for interactive workflows.",
      "Several examples run shell commands that can modify or delete files if executed directly.",
      "Interactive fzf workflows may not work in noninteractive automation or restricted shells.",
      "The skill provides command patterns, not a parser, index, or automated search service."
    ],
    "use_cases": [
      {
        "title": "Repository Navigation",
        "description": "Find files by name, type, path, age, or size before opening the most relevant results.",
        "target_user": "Software developers"
      },
      {
        "title": "Code Investigation",
        "description": "Search for symbols, TODO items, imports, and repeated patterns with context and counts.",
        "target_user": "Maintainers"
      },
      {
        "title": "Interactive Review",
        "description": "Use fzf previews to inspect matches, choose files, and prepare focused editor or git actions.",
        "target_user": "DevOps engineers"
      }
    ],
    "prompt_templates": [
      {
        "title": "Find Matching Files",
        "scenario": "Beginner file discovery",
        "prompt": "Use file-search to find Python files related to authentication. Show the search approach and explain each filter."
      },
      {
        "title": "Search Code Safely",
        "scenario": "Targeted content search",
        "prompt": "Search for TODO and FIXME entries in src. Include counts and context, and do not modify files."
      },
      {
        "title": "Preview Search Results",
        "scenario": "Interactive navigation",
        "prompt": "Build an fzf workflow to search for API routes, preview matches, and open selected files in my editor."
      },
      {
        "title": "Plan a Review Workflow",
        "scenario": "Advanced repository triage",
        "prompt": "Create a safe fd, rg, and fzf plan for locating deprecated TypeScript APIs, reviewing matches, and staging only approved files."
      }
    ],
    "output_examples": [
      {
        "input": "Find configuration files in a monorepo.",
        "output": [
          "A scoped file search plan by name and extension.",
          "Recommended exclusions for generated directories.",
          "Next steps for narrowing results by path."
        ]
      },
      {
        "input": "Search for deprecated API usage.",
        "output": [
          "A content search plan with context lines and counts.",
          "A review-first workflow before any edits.",
          "A summary of likely files to inspect."
        ]
      },
      {
        "input": "Open matching files interactively.",
        "output": [
          "An fzf preview workflow for selecting files.",
          "Editor navigation guidance for selected matches.",
          "Safety notes for commands that can change files."
        ]
      }
    ],
    "best_practices": [
      "Preview matches before running commands that modify files.",
      "Scope searches to a path or file type before expanding to the full repository.",
      "Use null-delimited pipelines or quoted variables when file names come from search output."
    ],
    "anti_patterns": [
      "Running deletion or rewrite commands from examples without checking selected files.",
      "Using broad empty searches across the whole repository when a path or type filter is known.",
      "Passing untrusted file names through xargs without safe delimiters or confirmation."
    ],
    "faq": [
      {
        "question": "What tools must be installed?",
        "answer": "fd and ripgrep are required. fzf is needed for interactive workflows, and some examples also use bat, eza, sd, or git."
      },
      {
        "question": "Does this skill change files automatically?",
        "answer": "No. It documents command workflows, but some examples can modify or delete files if a user or agent runs them."
      },
      {
        "question": "Can I use it with Claude, Codex, and Claude Code?",
        "answer": "Yes. The metadata lists Claude, Codex, and Claude Code as supported tools."
      },
      {
        "question": "How should I use it in a large repository?",
        "answer": "Start with path, file type, and ignore filters. Expand the search only after the first results are too narrow."
      },
      {
        "question": "Does it replace IDE search?",
        "answer": "No. It complements IDE search with fast terminal workflows, counts, previews, and scriptable filters."
      },
      {
        "question": "Is it safe for automation?",
        "answer": "Use read-only searches for automation. Require explicit approval before write, delete, rename, git, or editor commands."
      }
    ]
  },
  "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-workflows.md",
          "type": "file",
          "path": "references/advanced-workflows.md",
          "lines": 315
        }
      ]
    },
    {
      "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": 102
    }
  ]
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall