Agent skill

Windows Safe Grep

by julianromli in julianromli/opencode-template

A skill your agent uses when grep/ripgrep fails on Windows due to paths with backslash-space sequences creating malformed paths like 'nul' from \n+ul

No licenceAuto-check passed

Install Windows Safe Grep

skills CLI
$ npx skills add julianromli/opencode-template --skill windows-safe-grep -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install julianromli/opencode-template windows-safe-grep --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/julianromli/opencode-template.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill/windows-safe-grep .claude/skills/windows-safe-grep && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
windows-safe-grep
GitHub stars
144
Token cost
~387 tokens
SKILL.md length
121 words
Files
2
Skills in repo
16
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when grep/ripgrep fails on Windows due to paths with backslash-space sequences creating malformed paths like 'nul' from \n+ul

  • Works in 3 steps: Use this skill → Replace the path with forward slashes:… → Or use the bash command pattern with…
  • Grep/ripgrep fails on Windows due to paths with backslash-space sequences creating malformed paths like nul from \n+ul
  • SKILL.md covers Problem, Solution, Usage and Example
  • Runs Shell scripts from its folder; calls rg

What it does

Windows Safe Grep is an agent skill from julianromli/opencode-template. Use when grep/ripgrep fails on Windows due to paths with backslash-space sequences creating malformed paths like 'nul' from \n+ul

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `safe-grep.sh`).

The repository describes itself as: OpenCode CLI Template by @faizntfd.

When your agent uses it

  • Grep/ripgrep fails on Windows due to paths with backslash-space sequences creating malformed paths like nul from \n+ul

Example prompts

  • “/windows-safe-grep”

Requirements

  • A Bash shell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Use this skill
  2. Replace the path with forward slashes: D:\Projects\Vibe Code\isometricid → /d/Projects/Vibe Code/isometricid
  3. Or use the bash command pattern with proper quoting

What it can do on your machine

Read from SKILL.md and the folder at commit 37ceab2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Windows Safe Grep loads about 387 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 121 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~387

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 121 words (~387 tokens).

“On Windows, paths containing backslash-space sequences (e.g., D:\Projects\Vibe Code\isometricid) can cause ripgrep to fail because:”

— opening of SKILL.md by julianromli
name
windows-safe-grep

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skill/windows-safe-grep of julianromli/opencode-template.

  • SKILL.md
  • safe-grep.sh

Open the folder on GitHubat commit 37ceab2

Compare with similar skills

Windows Safe Grep next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Windows Safe Grep compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windows Safe Grep this skilljulianromli/opencode-template144—~387Automated safety check: PassNone
Ripgreppenpot/penpot61k—~788Automated safety check: PassMPL-2.0
Windows Desktop E2Eaffaan-m/ECC275k1 repos~7.6kAutomated safety check: PassMIT
Windows Desktop E2Eaffaan-m/ECC275k—~5.5kAutomated safety check: PassMIT
Windows Shell Reliabilitysickn33/agentic-awesome-skills47k2 repos~1kAutomated safety check: PassMIT
Windows Path Rename981377660LMT/algorithm-study277—~540Automated safety check: PassNone

Similar skills

  • Ripgrep

    penpot/penpot

    Blazingly fast text search tool - recursively searches directories for regex patterns with respect to gitignore rules.

    61k GitHub stars~788 tokensUpdated today
    Auto-check passed
  • E2E testing for Windows native desktop apps (WPF, WinForms, Win32/MFC, Qt) using pywinauto and Windows UI Automation.

    275k GitHub starsUsed in 1 repo~7.6k tokens
    Testing & QAAuto-check passed
  • E2E testing for Windows native desktop apps (WPF, WinForms, Win32/MFC, Qt) using pywinauto and Windows UI Automation.

    275k GitHub stars~5.5k tokensUpdated 3 days ago
    Testing & QAAuto-check passed
  • Windows Shell Reliability

    sickn33/agentic-awesome-skills

    Reliable command execution on Windows: paths, encoding, and common binary pitfalls.

    47k GitHub starsUsed in 2 repos~1k tokens
    DevOps & CloudAuto-check passed
  • Windows Path Rename

    981377660LMT/algorithm-study

    Sanitize Git paths that are invalid on Windows (for example :, ", |, ?, and trailing dot/space) and commit safe renames.

    277 GitHub stars~540 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Windows Hardening

    sickn33/agentic-awesome-skills

    Harden Windows servers per security baselines and CIS benchmarks.

    47k GitHub starsUsed in 2 repos~4.4k tokens
    Auto-check passed

More from julianromli/opencode-template

All 16 skills in this repo
  • Using Git Worktrees

    julianromli/opencode-template

    A skill your agent uses when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory…

    144 GitHub starsUsed in 28 repos~1.4k tokens
    Auto-check passed
  • Ralph

    julianromli/opencode-template

    Autonomous agent loop for completing features. An agent skill from julianromli/opencode-template.

    144 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Rsc Data Optimizer

    julianromli/opencode-template

    Optimize Next.js App Router data fetching by converting slow client-side fetching to fast server-side fetching using React Server Components (RSC).

    144 GitHub starsUsed in 1 repo~805 tokens
    Auto-check passed
  • Shadcn Management

    julianromli/opencode-template

    Manage shadcn/ui components using MCP tools. An agent skill from julianromli/opencode-template.

    144 GitHub starsUsed in 1 repo~733 tokens
    Auto-check passed
  • Frontend UI Animator

    julianromli/opencode-template

    Analyze and implement purposeful UI animations for Next.js + Tailwind + React projects.

    144 GitHub stars~1.2k tokensUpdated 8 mo ago
    Auto-check passed
  • Agents Md Generator

    julianromli/opencode-template

    Generate hierarchical AGENTS.md structures for codebases. An agent skill from julianromli/opencode-template.

    144 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check: notes

Questions about Windows Safe Grep

What does Windows Safe Grep do?

A skill your agent uses when grep/ripgrep fails on Windows due to paths with backslash-space sequences creating malformed paths like 'nul' from \n+ul. Windows Safe Grep is an agent skill from julianromli/opencode-template.

When should I use Windows Safe Grep?

Windows Safe Grep fits situations like: grep/ripgrep fails on Windows due to paths with backslash-space sequences creating malformed paths like nul from \n+ul.

How do I install Windows Safe Grep in Claude Code?

Run `npx skills add julianromli/opencode-template --skill windows-safe-grep -a claude-code`. Or copy the skill folder (skill/windows-safe-grep in julianromli/opencode-template) into .claude/skills/windows-safe-grep in your project. Claude Code loads it when a task matches its description.

How do I install Windows Safe Grep in Codex?

Run `npx skills add julianromli/opencode-template --skill windows-safe-grep -a codex`. Or copy the skill folder (skill/windows-safe-grep in julianromli/opencode-template) into .agents/skills/windows-safe-grep in your project. Codex loads it when a task matches its description.

Can I use Windows Safe Grep in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add julianromli/opencode-template --skill windows-safe-grep -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/windows-safe-grep, .gemini/skills/windows-safe-grep, .github/skills/windows-safe-grep and .opencode/skills/windows-safe-grep in your project.

What does Windows Safe Grep need to run?

Going by SKILL.md and its folder, Windows Safe Grep needs a shell for the scripts in its folder and the command-line tools its instructions call (rg). Our summary lists: A Bash shell.

Does Windows Safe Grep access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Windows Safe Grep safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Windows Safe Grep use?

No licence was found for Windows Safe Grep or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Windows Safe Grep use?

About 387 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Windows Safe Grep?

Skills that share tags, products or a category with Windows Safe Grep: Ripgrep (penpot/penpot, 61k stars), Windows Desktop E2E (affaan-m/ECC, 275k stars), Windows Desktop E2E (affaan-m/ECC, 275k stars) and Windows Shell Reliability (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windows Safe Grep?

julianromli (a GitHub user) maintains it in julianromli/opencode-template, which has 144 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on February 3, 2026.

Source: julianromli/opencode-template on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.