skills.rest
djimontyp
djimontypCOMMUNITY
Explore all skills by this author →
Website𝕏@djimontypGitHub

pycharm-refs

Format file references as path:line_number for clickable code locations.

Updated Aug 27, 2026
Search Tags:#developer tools#debugging#reporting#code navigation#JetBrains#IDE integration#PyCharm
One-click install
npx skills add https://github.com/djimontyp/task-tracker --skill pycharm-refs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pycharm-refs
Source: https://github.com/djimontyp/task-tracker/tree/main/.claude/skills/pycharm-refs
Command: npx skills add https://github.com/djimontyp/task-tracker --skill pycharm-refs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines code review and debugging by generating clickable file:// URLs with absolute paths and line numbers, allowing users to jump directly to relevant code in PyCharm/JetBrains IDEs from reports or findings.

Core Features & Use Cases

  • Instant Code Navigation: Creates links that open directly in your IDE, eliminating manual file searching and saving you time.
  • Actionable Reporting: Ensures bug reports, performance analyses, and implementation summaries include direct links to the code in question.
  • Contextual References: Distinguishes between actionable code references (clickable) and conceptual documentation (non-clickable) for clarity.
  • Use Case: After an AI agent identifies a performance bottleneck in your backend, it uses this skill to provide a report with a clickable link like file:///path/to/backend/app/services/classification.py:156, letting you instantly jump to the exact line of code.

Quick Start

To generate a clickable reference in a report:

Use the format:

file://{{env.WORKING_DIRECTORY}}/path/to/file.py:LINE_NUMBER

Example:

Found issue at:

file:///Users/youruser/project/backend/app/services/task_service.py:45

Frequently Asked Questions about pycharm-refs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create clickable code links that open in PyCharm?▼

Clickable code links use the format `file:///absolute/path/to/file.py:LINE_NUMBER`. This format lets Claude Code generate references that open directly in PyCharm or other JetBrains IDEs when clicked, eliminating manual file searching during code review and debugging.

Can I use code references in bug reports and analysis results?▼

Yes. Format file references as `path:line_number` in investigation reports, bug reports, and implementation summaries. This ensures actionable reporting where users can instantly jump to exact code locations instead of manually searching through files.

What's the correct syntax for code navigation links with line ranges?▼

Use `file:///path/to/file.py:START_LINE-END_LINE` for ranges or `file:///path/to/file.py:LINE_NUMBER` for single lines. Include the working directory context and absolute paths; avoid additional markup or `file://` variations to maintain IDE compatibility.

How do I distinguish between clickable code references and conceptual documentation?▼

Apply the `path:line_number` format only to actionable code references tied to specific locations. Conceptual or general documentation remains non-clickable text. This clarity helps users prioritize navigation to relevant code during debugging and review cycles.

Do I need absolute paths for IDE navigation to work correctly?▼

Absolute paths ensure reliable IDE navigation across environments. While relative paths are supported, absolute paths with the working directory context guarantee PyCharm and JetBrains IDEs locate and open the correct file at the specified line number consistently.

What file formats and programming languages does code navigation support?▼

Code navigation works with any file format and language that JetBrains IDEs support, including Python, Java, JavaScript, and more. The `path:line_number` format is format-agnostic; the IDE determines how to open and display the referenced file.

Related Skills

Explore More Software Engineering Skills→
ntaksh42ntaksh42
1

save-report

Classify conversation outputs and write numbered HTML reports to output-config.toml paths.

Community
Intermediate
pluginagentmarketplacepluginagentmarketplace
3

red-team-reporting

Generate security assessment reports from structured findings in Markdown, HTML, PDF, or DOCX.

Community
Basic
CloudyWingCloudyWing

code-review

Review source code for correctness, security, performance, and maintainability issues.

Community
Intermediate
slowlyCslowlyC
154

cuda-skill

Search local NVIDIA CUDA documentation for PTX and API references.

Community
Advanced