Official agent skill

Symbols API

by JetBrains in JetBrains/intellij-community

Use IntelliJ Symbol API for declarations, references, and rename.

OfficialCustom licenceAuto-check passed

Install Symbols API

skills CLI
$ npx skills add JetBrains/intellij-community --skill symbols-api -a claude-code

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

GitHub CLI
$ gh skill install JetBrains/intellij-community symbols-api --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/JetBrains/intellij-community.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/symbols-api .claude/skills/symbols-api && 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
symbols-api
GitHub stars
21k
Token cost
~2.7k tokens
SKILL.md length
1,060 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
Custom licence

At a glance

Use IntelliJ Symbol API for declarations, references, and rename.

  • SKILL.md covers Contract and lifecycle, Declarations, References — three kinds and Hooking a Symbol into platform…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Symbols API is an agent skill from JetBrains/intellij-community, published by the product's own GitHub organization. Use IntelliJ Symbol API for declarations, references, and rename.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with JetBrains IDEs and Java. The repository describes itself as: IntelliJ IDEA & IntelliJ Platform.

Example prompts

  • “/symbols-api”

What it can do on your machine

Read from SKILL.md and the folder at commit cbaf50b. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are java).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • plugins.jetbrains.com

    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

Symbols API loads about 2.7k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 1,060 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,060 words (~2,664 tokens).

“com.intellij.model.Symbol (community/platform/core-api/src/com/intellij/model/Symbol.java) is the platform's generic replacement for "resolve a PsiReference to a PsiElement". A Symbol represents a semantic element in some model — a language, a framework, a database schema — and decouples navigation/find-usages/rename/documentation from PSI. A Symbol is…”

— opening of SKILL.md by JetBrains, Custom licence
name
symbols-api

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/symbols-api of JetBrains/intellij-community.

Open the folder on GitHubat commit cbaf50b

Compare with similar skills

Symbols API 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.

Symbols API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Symbols API this skillJetBrains/intellij-community21k—~2.7kAutomated safety check: PassCustom licence
Release Pluginflutter/flutter-intellij2k—~1kAutomated safety check: PassBSD-3-Clause
Doc View Contract Designliuzhihang/doc-view207—~539Automated safety check: PassMIT
Amplicode InstallAmplicode/spring-skills126—~2.6kAutomated safety check: PassNone
Idea MCPdtprj/dongting208—~698Automated safety check: PassApache-2.0
Ij Debuggerxpinjection/test-driven-spring-boot112—~6.4kAutomated safety check: PassMIT

Similar skills

  • Release Plugin

    flutter/flutter-intellij

    Prepare and execute a new release for the flutter-intellij plugin, including updating dependencies, compatibility bounds, changelogs, and verification.

    2k GitHub stars~1k tokensUpdated today
    MobileAuto-check passed
  • Doc View Contract Design

    liuzhihang/doc-view

    A skill your agent uses when defining or reviewing Doc View behavior contracts before changing PSI parsing, DTOs, Markdown output, uploads, exports, settings, UI-visible behavior, or IntelliJ…

    207 GitHub stars~539 tokensUpdated 23 days ago
    Documents & OfficeAuto-check passed
  • Amplicode Install

    Amplicode/spring-skills

    Installs the Amplicode IntelliJ plugin into IntelliJ IDEA (Ultimate/Community) and GigaIDE on the user's machine.

    126 GitHub stars~2.6k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Idea MCP

    dtprj/dongting

    IntelliJ IDEA MCP for Java code analysis, testing, refactoring, and project navigation.

    208 GitHub stars~698 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Ij Debugger

    xpinjection/test-driven-spring-boot

    Debugger-first runtime root-cause analysis for JVM code in IntelliJ IDEA.

    112 GitHub stars~6.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Doc View Java Maintenance

    liuzhihang/doc-view

    A skill your agent uses when implementing or reviewing Java-only Doc View production changes, especially PSI parsing, services, DTOs, UI, integrations, settings, export, or IntelliJ Platform behavior.

    207 GitHub stars~557 tokensUpdated 23 days ago
    Auto-check passed

More from JetBrains/intellij-community

All 39 skills in this repo
  • Youtrack Community

    JetBrains/intellij-community

    Official

    YouTrack CLI for a community checkout; the monorepo uses youtrack.

    21k GitHub stars~3.2k tokensUpdated today
    Auto-check: notes
  • Compare Python Typecheckers

    JetBrains/intellij-community

    Official

    Compare Python type inference with ty, pyrefly, and basedpyright.

    21k GitHub stars~617 tokensUpdated today
    Auto-check passed
  • Sibling Checkout Commits

    JetBrains/intellij-community

    Official

    Take commits from a sibling checkout as patches, without a fetch.

    21k GitHub stars~753 tokensUpdated today
    Auto-check passed
  • Code Style

    JetBrains/intellij-community

    Official

    Apply IntelliJ Kotlin and Java code style when writing or reviewing.

    21k GitHub stars~795 tokensUpdated today
    Auto-check passed
  • Notebook For Experiment

    JetBrains/intellij-community

    Official

    Create reproducible Jupyter notebooks for performance experiments.

    21k GitHub stars~4.4k tokensUpdated today
    Auto-check: warnings
  • Jewel Markdown

    JetBrains/intellij-community

    Official

    Build or debug Jewel Markdown parsing, rendering, and styling.

    21k GitHub stars~4.3k tokensUpdated today
    Auto-check passed

Questions about Symbols API

What does Symbols API do?

Use IntelliJ Symbol API for declarations, references, and rename. Symbols API is an agent skill from JetBrains/intellij-community, published by the product's own GitHub organization. Use IntelliJ Symbol API for declarations, references, and rename.

How do I install Symbols API in Claude Code?

Run `npx skills add JetBrains/intellij-community --skill symbols-api -a claude-code`. Or copy the skill folder (.agents/skills/symbols-api in JetBrains/intellij-community) into .claude/skills/symbols-api in your project. Claude Code loads it when a task matches its description.

How do I install Symbols API in Codex?

Run `npx skills add JetBrains/intellij-community --skill symbols-api -a codex`. Or copy the skill folder (.agents/skills/symbols-api in JetBrains/intellij-community) into .agents/skills/symbols-api in your project. Codex loads it when a task matches its description.

Can I use Symbols API 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 JetBrains/intellij-community --skill symbols-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/symbols-api, .gemini/skills/symbols-api, .github/skills/symbols-api and .opencode/skills/symbols-api in your project.

What does Symbols API need to run?

SKILL.md names no scripts, command-line tools or credentials: Symbols API is instructions for the agent only.

Does Symbols API access the network?

SKILL.md names 1 domain. As links in the text: plugins.jetbrains.com. This is read from the text; nothing was executed.

Is Symbols API 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 Symbols API use?

Symbols API has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Symbols API use?

About 2.7k tokens (SKILL.md is roughly 11k 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 Symbols API?

Skills that share tags, products or a category with Symbols API: Release Plugin (flutter/flutter-intellij, 2k stars), Doc View Contract Design (liuzhihang/doc-view, 207 stars), Amplicode Install (Amplicode/spring-skills, 126 stars) and Idea MCP (dtprj/dongting, 208 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Symbols API?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/intellij-community, which has 20,617 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 9, 2026.

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