mcpbeat Sign in

Repoprompt Skill for Claude

Use RepoPrompt CLI for token-efficient codebase exploration

1k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
3880
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/parcadei/Continuous-Claude-v3 --skill repoprompt

The instruction itself

20 sections, as written by the author

RepoPrompt Skill

When to Use

  • Explore codebase structure (tree, codemaps)
  • Search code with context lines
  • Get code signatures without full file content (token-efficient)
  • Read file slices (specific line ranges)
  • Build context for tasks

Token Optimization

RepoPrompt is more token-efficient than raw file reads:

  • structure → signatures only (not full content)
  • read --start-line --limit → slices instead of full files
  • search --context-lines → relevant matches with context

CLI Usage

# If installed to PATH (Settings → MCP Server → Install CLI to PATH)
rp-cli -e 'command'

# Or use the alias (configure in your shell)
repoprompt_cli -e 'command'

Commands Reference

File Tree

# Full tree
rp-cli -e 'tree'

# Folders only
rp-cli -e 'tree --mode folders'

# Selected files only
rp-cli -e 'tree --mode selected'

Code Structure (Codemaps) - TOKEN EFFICIENT

# Structure of specific paths
rp-cli -e 'structure src/auth/'

# Structure of selected files
rp-cli -e 'structure --scope selected'

# Limit results
rp-cli -e 'structure src/ --max-results 10'
# Basic search
rp-cli -e 'search "pattern"'

# With context lines
rp-cli -e 'search "error" --context-lines 3'

# Filter by extension
rp-cli -e 'search "TODO" --extensions .ts,.tsx'

# Limit results
rp-cli -e 'search "function" --max-results 20'

Read Files - TOKEN EFFICIENT

# Full file
rp-cli -e 'read path/to/file.ts'

# Line range (slice)
rp-cli -e 'read path/to/file.ts --start-line 50 --limit 30'

# Last N lines (tail)
rp-cli -e 'read path/to/file.ts --start-line -20'

Selection Management

# Add files to selection
rp-cli -e 'select add src/auth/'

# Set selection (replace)
rp-cli -e 'select set src/api/ src/types/'

# Clear selection
rp-cli -e 'select clear'

# View current selection
rp-cli -e 'select get'

Workspace Context

# Get full context
rp-cli -e 'context'

# Specific includes
rp-cli -e 'context --include prompt,selection,tree'

Chain Commands

# Multiple operations
rp-cli -e 'select set src/auth/ && structure --scope selected && context'

Workspaces

# List workspaces
rp-cli -e 'workspace list'

# List tabs
rp-cli -e 'workspace tabs'

# Switch workspace
rp-cli -e 'workspace switch "ProjectName"'

AI Chat (uses RepoPrompt's models)

# Send to chat
rp-cli -e 'chat "How does the auth system work?"'

# Plan mode
rp-cli -e 'chat "Design a new feature" --mode plan'

Context Builder (AI-powered file selection)

# Auto-select relevant files for a task
rp-cli -e 'builder "implement user authentication"'

Workflow Shorthand Flags

# Quick operations without -e syntax
rp-cli --workspace MyProject --select-set src/ --export-context ~/out.md
rp-cli --chat "How does auth work?"
rp-cli --builder "implement user authentication"

Script Files (.rp)

For repeatable workflows, save commands to a script:

# daily-export.rp
workspace switch Frontend
select set src/components/
context --all > ~/exports/frontend.md

Run with:

rp-cli --exec-file ~/scripts/daily-export.rp

CLI Flags

| Flag | Purpose |

|------|---------|

| -e 'cmd' | Execute command(s) |

| -w <id> | Target window ID |

| -q | Quiet mode |

| -d <cmd> | Detailed help for command |

| --wait-for-server 5 | Wait for connection (scripts) |

Async Operations (tmux)

For long-running operations like builder, use the async script:

# Start context builder async
uv run python -m runtime.harness scripts/repoprompt_async.py \
    --action start --task "understand the auth system"

# With workspace switch
uv run python -m runtime.harness scripts/repoprompt_async.py \
    --action start --workspace "MyProject" --task "explore API patterns"

# Check status
uv run python -m runtime.harness scripts/repoprompt_async.py --action status

# Get result when done
uv run python -m runtime.harness scripts/repoprompt_async.py --action result

# Kill if needed
uv run python -m runtime.harness scripts/repoprompt_async.py --action kill

Note

Requires RepoPrompt app running with MCP Server enabled.

Other skills for the same job

different authors, same section of the catalogue
MCP Builder
by anthropics
vendor ×13

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

30k tokens scripts
Changelog Generator
by frostant
×9

Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.

774 tokens
Finishing A Development Branch
by ZhanlinCui
×7

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup

1k tokens
MCP Builder
by JayZeeDesign
×7

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

37k tokens scripts
Vercel React Native Skills
by vercel-labs
vendor ×6

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

39k tokens
Vercel React Best Practices
by ratacat
×5

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

34k tokens
Next Best Practices
by vercel-labs
vendor ×4

Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling

20k tokens
Using Git Worktrees
by ZhanlinCui
×4

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

1k tokens

How to use it

Copy the folder

Take parcadei/repoprompt from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.