Agent skill

jetbrains-skill

Use the JetBrains IDE MCP Server (IntelliJ IDEA 2025.2+) to let an external client drive IDE-backed actions: run Run Configurations, execute commands in the IDE terminal, read/create/edit project files, search via IDE indexes (text/regex), retrieve code inspections for a file, fetch symbol info, perform rename refactoring, list modules/dependencies/repos, open files in the editor, and reformat code. Use when you want IDE-grade indexing/refactoring/inspection instead of raw shell scripting.

View SKILL.md on GitHub Repository
Stars 9
Forks 2

Install this agent skill to your Project

npx add-skill https://github.com/Ry-Run/run-skills/tree/main/skills/jetbrains-skill

SKILL.md

JetBrains Skill

Quick start

Goal: use JetBrains IDE features (index, inspections, refactoring, run configurations, integrated terminal) as tools for an external client, while keeping changes auditable and safe.

notes + tool list (condensed): skills/jetbrains-skill/references/jetbrains-skill.md.

Connection & modes

Client setup (done in the IDE)

  • Settings → Tools → MCP Server
  • Enable MCP Server
  • Use “Auto-configure” for supported clients (updates their JSON config), or copy SSE / Stdio config for manual setup
  • Restart the external client to apply changes

Brave Mode (no confirmations)

The IDE can allow running shell commands / run configurations without per-action confirmation (“Brave mode”). This increases automation power but also increases risk. Require explicit user confirmation before enabling/disabling it.

Workflow decision tree

  1. Do I need IDE-grade analysis/refactoring?
  • File diagnostics: get_file_problems
  • Symbol semantics / docs: get_symbol_info
  • Safe rename across project: rename_refactoring (prefer over plain text replace)
  • Indexed search: search_in_files_by_text / search_in_files_by_regex
  • Find files: find_files_by_name_keyword (fast, name-only) or find_files_by_glob (path glob)
  1. Do I just need file operations in the project?
  • Read file text: get_file_text_by_path
  • Create file: create_new_file
  • Targeted replace: replace_text_in_file (auto-saves)
  • Open in editor: open_file_in_editor
  • Reformat: reformat_file
  1. Do I need to run something?
  • List run configs: get_run_configurations
  • Run a config (wait for completion): execute_run_configuration
  • Run a terminal command in IDE: execute_terminal_command (may require confirmation; output is capped)

Constraints (avoid common mistakes)

  • Always pass projectPath when known to avoid ambiguity.
  • Many tools require paths relative to the project root and only operate on project files.
  • Line/column positions are 1-based for location-based tools.
  • Prefer controlling output with maxLinesCount + truncateMode; do not rely on defaults for large outputs.
  • Terminal commands and running configurations are high-risk; require explicit confirmation for any potentially destructive command. Brave Mode removes guardrails.

Recommended high-value patterns

Debug via inspections first

  1. get_file_problems to find errors/warnings → 2) get_symbol_info to understand the code → 3) rename_refactoring for renames → 4) replace_text_in_file only for truly textual changes.

Use indexed search for scale

Prefer search_in_files_by_text / search_in_files_by_regex since it uses IDE search/indexing and highlights matches with ||.

Running and output control

Use execute_run_configuration with a sane timeout (ms). For terminal commands use execute_terminal_command, but remember output caps; for huge output, redirect to a file and read it via file tools.

References

  • notes + tool list (condensed): skills/jetbrains-skill/references/jetbrains-skill.md

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

Ry-Run/run-skills

desktop-commander

Use Desktop Commander MCP (typically tools like `mcp__desktop-commander__*`) to manage local files and long-running processes: read/write/search files, apply precise edits, work with Excel/PDFs, run terminal commands and interact with REPLs (Python/Node/SSH/DB), inspect/terminate processes, and review tool call history. Use when the task requires doing real work on the machine (editing code/configs, searching a repo, analyzing CSV/Excel, generating/modifying PDFs, running commands with streaming output).

9 2
Explore
mattpocock/skills

scaffold-exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

111,310 9,758
Explore
mattpocock/skills

git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results