Guidelines
akash-network/node
Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.
Handles multi-file renames and search-and-replace with the repren CLI: several patterns, swaps and case variants in one previewable pass with backups and undo.
Install repren Multi-File Rename and Replace
$ npx skills add jlevy/repren --skill repren -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jlevy/repren repren --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jlevy/repren.git skills-src && mkdir -p .claude/skills && cp -r skills-src/repren/skills .claude/skills/repren && rm -rf skills-srcUse ~/.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/
Install the "repren" agent skill from https://github.com/jlevy/repren/tree/master/repren/skills into .claude/skills/repren/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repren", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jlevy/repren/tree/master/repren/skillsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jlevy/repren --skill repren -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jlevy/repren repren --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jlevy/repren.git skills-src && mkdir -p .agents/skills && cp -r skills-src/repren/skills .agents/skills/repren && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "repren" agent skill from https://github.com/jlevy/repren/tree/master/repren/skills into .agents/skills/repren/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repren", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jlevy/repren --skill repren -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jlevy/repren repren --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jlevy/repren.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/repren/skills .cursor/skills/repren && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "repren" agent skill from https://github.com/jlevy/repren/tree/master/repren/skills into .cursor/skills/repren/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repren", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jlevy/repren.git --path repren/skills--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jlevy/repren --skill repren -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jlevy/repren repren --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jlevy/repren.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/repren/skills .gemini/skills/repren && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "repren" agent skill from https://github.com/jlevy/repren/tree/master/repren/skills into .gemini/skills/repren/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repren", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jlevy/repren reprenInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jlevy/repren --skill repren -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jlevy/repren.git skills-src && mkdir -p .github/skills && cp -r skills-src/repren/skills .github/skills/repren && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "repren" agent skill from https://github.com/jlevy/repren/tree/master/repren/skills into .github/skills/repren/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repren", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jlevy/repren --skill repren -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jlevy/repren repren --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jlevy/repren.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/repren/skills .opencode/skills/repren && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "repren" agent skill from https://github.com/jlevy/repren/tree/master/repren/skills into .opencode/skills/repren/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repren", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
repren- GitHub stars
- 374
- Token cost
- ~774 tokens
- SKILL.md length
- 319 words
- Files
- 1
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
Handles multi-file renames and search-and-replace with the repren CLI: several patterns, swaps and case variants in one previewable pass with backups and undo.
- Renaming a symbol across many files and the files named after it
- SKILL.md covers When to use repren, When not to use repren and Good to know
- Calls uvx
- Swapping two names throughout a codebase in one pass
What it does
The skill tells the agent when to reach for repren instead of the Edit tool or sed, perl and awk loops: any rename or replacement that spans more than a file or two. repren rewrites file contents and renames files and directories in one pass, applies many patterns at once including swaps like foo and bar, refactors an identifier across camelCase, snake_case, PascalCase and UPPER_CASE with --preserve-case, and supports regex capture groups.
Safety comes from the habit of running --dry-run first. repren writes atomically and leaves .orig backups, which --undo restores and --clean-backups removes. It does not read .gitignore and skips dotfiles by default, so scope with --include and --exclude. Single-file edits and language-aware refactors belong elsewhere, with an AST tool such as ast-grep. Run repren --docs for flags; if it is not installed, uvx repren@latest works.
When your agent uses it
- Renaming a symbol across many files and the files named after it
- Swapping two names throughout a codebase in one pass
- Refactoring an identifier in all of its case variants
- Applying a regex replacement with capture groups across a directory
Example prompts
- “Rename UserAccount to Member everywhere in src, including file names, and preview it first.”
- “Swap foo and bar across the whole repo in a single pass.”
- “Rewrite every figure N reference in docs to start with a capital F.”
- “Undo the last repren run and clean up the backups.”
Requirements
- repren on the PATH, or uv to run `uvx repren@latest`
- Pre-approved tools (allowed-tools): Bash(repren:*), Bash(uvx repren@latest:*), Read, Write
What it can do on your machine
Read from SKILL.md and the folder at commit 885ce5e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
Bash(repren:*)Bash(uvx repren@latest:*)ReadWrite
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
uvx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uvx, which can reach the network depending on how they are called.
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
repren Multi-File Rename and Replace loads about 774 tokens when it runs. Until then it costs about 154 tokens; SKILL.md has 319 words of instructions outside code blocks.
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
The full file from jlevy/repren at commit 885ce5e, republished under its MIT licence (© jlevy). 319 words, ~774 tokens.
Download SKILL.mdSave it as
.claude/skills/repren/SKILL.md (or your agent's skills folder).- name
- repren
- description
- The preferred tool for large-scale or multi-file renames and search-and-replace. Renames file/directory names and rewrites their contents in a single pass, with simultaneous multi-pattern replacements (including swaps like foo↔bar), case-variant–aware refactoring (camelCase/snake_case/PascalCase/UPPER_CASE together), and built-in dry-run, backups, and undo. Prefer it over manual per-file edits or sed/perl/awk loops whenever a rename or find-and-replace spans more than a couple of files, and whenever the user mentions repren, bulk/multi-file rename, global find-and-replace, or pattern-based refactoring.
- allowed-tools
- Bash(repren:*), Bash(uvx repren@latest:*), Read, Write
repren: multi-pattern rename and search-and-replace
repren does in one safe, previewable pass what hand edits and sed/perl/awk loops
do awkwardly: combined content and file/directory renames, simultaneous multi-pattern
replacement (including swaps), case-variant-aware refactoring, and atomic writes with
backups and undo.
If you are going to use repren, read its docs first: run
repren --docsfor the full flags, pattern-file format, examples, and edge cases. This skill only tells you when to reach for repren and which command;repren --docsandrepren --helpcarry the how.
Invocation: use
reprenif it is onPATH, otherwiseuvx repren@latest(no install needed, zero runtime dependencies). Always preview with--dry-runfirst.
When to use repren
Prefer repren over the Edit tool or shell loops whenever a rename or replacement spans more than a file or two. Reach for it when the task is to:
- Rename a symbol across many files —
repren --from=Old --to=New --word-breaks --full DIR - Rename a symbol and the files/directories named after it, together —
--fullrewrites contents and renames paths in one pass - Apply many replacements at once, or swap names (
foo↔bar) —repren --patterns=FILE --full DIR - Refactor an identifier across all case variants
(camelCase/snake_case/PascalCase/UPPER_CASE) — add
--preserve-case - Replace with a regex and capture groups across files —
repren --from='figure ([0-9]+)' --to='Figure \1' DIR - Make a bulk change you must preview, back up, and be able to reverse —
--dry-run, then run, then--undoor--clean-backups
For the exact flags, pattern-file syntax, scoping (--include/--exclude, --literal,
--at-once), and JSON output, read repren --docs.
When not to use repren
- A single-file or one-off edit — use the Edit tool.
- Language-aware or semantic refactors — use an AST tool such as ast-grep.
- Anything needing precise line-by-line control — use the Edit tool.
Good to know
- Always
--dry-runfirst. repren writes atomically and leaves.origbackups;--undorestores them,--clean-backupsremoves them. - repren does not read
.gitignore. It skips dotfiles (including.git/) by default; scope everything else explicitly with--include/--exclude. Seerepren --docs.
© jlevy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in repren/skills of jlevy/repren.
Open the folder on GitHubat commit 885ce5e
Compare with similar skills
repren Multi-File Rename and Replace 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| repren Multi-File Rename and Replace this skilljlevy/repren | 374 | — | ~774 | Automated safety check: Pass | MIT | |
| Guidelinesakash-network/node | 1.1k | 22 repos | ~577 | Automated safety check: Pass | MIT | |
| Component Refactoringlangflow-ai/langflow | 156k | — | ~3.5k | Automated safety check: Pass | MIT | |
| Migrate Core Code to Submodulestinyhumansai/openhuman | 42k | — | ~2.6k | Automated safety check: Pass | GPL-3.0 | |
| Systematic Code Refactoringluongnv89/claude-howto | 42k | — | ~3k | Automated safety check: Pass | MIT | |
| Codexskills-directory/skill-codex | 1.5k | 3 repos | ~1.8k | Automated safety check: Pass | MIT |
Similar skills
Component Refactoring
langflow-ai/langflow
Refactor high-complexity React components in Langflow frontend.
Migrate Core Code to Submodules
tinyhumansai/openhuman
Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.
Systematic Code Refactoring
luongnv89/claude-howto
Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.
Codex
skills-directory/skill-codex
A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing
Ponytail
DavidObando/gsharp
Forces the laziest solution that actually works, simplest, shortest, most minimal.
More from jlevy/repren
Flowmark Markdown Formatter
jlevy/repren
Formats Markdown with the Flowmark auto-formatter for typographic cleanup and semantic line breaks, and helps adopt it across a repository.
Related
Categories
Questions about repren Multi-File Rename and Replace
What does repren Multi-File Rename and Replace do?
Handles multi-file renames and search-and-replace with the repren CLI: several patterns, swaps and case variants in one previewable pass with backups and undo. The skill tells the agent when to reach for repren instead of the Edit tool or sed, perl and awk loops: any rename or replacement that spans more than a file or two. repren rewrites file contents and renames files and directories in one pass, applies many patterns at once including swaps like foo and bar, refactors an identifier across camelCase, snake_case, PascalCase and UPPER_CASE with --preserve-case, and supports regex capture groups.
When should I use repren Multi-File Rename and Replace?
repren Multi-File Rename and Replace fits situations like: renaming a symbol across many files and the files named after it; swapping two names throughout a codebase in one pass; refactoring an identifier in all of its case variants; applying a regex replacement with capture groups across a directory.
How do I install repren Multi-File Rename and Replace in Claude Code?
Run `npx skills add jlevy/repren --skill repren -a claude-code`. Or copy the skill folder (repren/skills in jlevy/repren) into .claude/skills/repren in your project. Claude Code loads it when a task matches its description.
How do I install repren Multi-File Rename and Replace in Codex?
Run `npx skills add jlevy/repren --skill repren -a codex`. Or copy the skill folder (repren/skills in jlevy/repren) into .agents/skills/repren in your project. Codex loads it when a task matches its description.
Can I use repren Multi-File Rename and Replace 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 jlevy/repren --skill repren -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repren, .gemini/skills/repren, .github/skills/repren and .opencode/skills/repren in your project.
What does repren Multi-File Rename and Replace need to run?
Going by SKILL.md and its folder, repren Multi-File Rename and Replace needs the command-line tools its instructions call (uvx). Our summary lists: repren on the PATH, or uv to run `uvx repren@latest`. Its frontmatter pre-approves these tools: Bash(repren:*), Bash(uvx repren@latest:*), Read, Write.
Does repren Multi-File Rename and Replace access the network?
SKILL.md contains no URLs. Its commands use uvx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is repren Multi-File Rename and Replace 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 repren Multi-File Rename and Replace use?
repren Multi-File Rename and Replace is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does repren Multi-File Rename and Replace use?
About 774 tokens (SKILL.md is roughly 3.1k 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 repren Multi-File Rename and Replace?
Skills that share tags, products or a category with repren Multi-File Rename and Replace: Guidelines (akash-network/node, 1.1k stars), Component Refactoring (langflow-ai/langflow, 156k stars), Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars) and Systematic Code Refactoring (luongnv89/claude-howto, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains repren Multi-File Rename and Replace?
jlevy (a GitHub user) maintains it in jlevy/repren, which has 374 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 26, 2026.
Source: jlevy/repren on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.