Agent skill

intellij-plugin-builder

Guide for creating IntelliJ Platform plugins using Gradle and Kotlin/Java. Use when users want to create, configure, or develop plugins for IntelliJ IDEA or other JetBrains IDEs.

View SKILL.md on GitHub Repository
Stars 6
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/titonio/opencode-jb/tree/main/.opencode/skill/intellij-plugin-builder

SKILL.md

IntelliJ Plugin Builder

Overview

This skill provides templates, best practices, and reference documentation for building IntelliJ Platform plugins. It covers project setup, core components (Actions, Services, Listeners), and configuration using the IntelliJ Platform Gradle Plugin (2.x).

It includes the full official IntelliJ SDK documentation for offline reference.

Workflow

1. Project Setup

Use the provided initialization script to scaffold a new project with the correct structure and configuration.

bash
python3 .claude/skills/intellij-plugin-builder/scripts/init_project.py "MyPlugin" "com.example.myplugin"

This will create:

  • A standard Gradle project structure (src/main/kotlin, src/main/resources).
  • build.gradle.kts configured with the IntelliJ Platform Gradle Plugin (2.x).
  • plugin.xml with your ID and name.
  • gradle.properties and .gitignore.

2. Core Development

Refer to references/plugin_structure.md for details on:

  • Actions: Creating menu items and toolbar buttons.
  • Services: Managing state and logic.
  • Listeners: Reacting to IDE events.
  • Extensions: Integrating with the IDE (Tool Windows, Inspections, etc.).

3. Common Tasks & Tutorials

The skill includes the full IntelliJ SDK documentation. Here are quick links to common tasks:

  • Creating Actions: references/intellij-sdk-docs/topics/tutorials/actions_tutorial.md
  • Tool Windows: references/intellij-sdk-docs/topics/basics/plugin_structure/plugin_tool_windows.md
  • Inspections: references/intellij-sdk-docs/topics/tutorials/code_inspections.md
  • Listeners: references/intellij-sdk-docs/topics/basics/plugin_structure/plugin_listeners.md
  • Services: references/intellij-sdk-docs/topics/basics/plugin_structure/plugin_services.md
  • Settings/Config: references/intellij-sdk-docs/topics/tutorials/settings_tutorial.md

4. Building and Running

  • Run ./gradlew runIde to start a sandbox IDE instance with your plugin installed.
  • Run ./gradlew buildPlugin to package the plugin for distribution.
  • Run ./gradlew test to run unit tests (JUnit 5 configured).

Resources

scripts/

  • init_project.py: Scaffolds a complete IntelliJ Plugin project structure.
  • add_action.py: Interactive script to scaffold a new Action class (Kotlin) and generate the XML registration snippet.

references/

  • plugin_structure.md: Detailed guide on project structure, key components (Actions, Services, Listeners), and Gradle configuration.
  • intellij-sdk-docs/: Full clone of the official IntelliJ SDK documentation.
    • topics/basics/: Core concepts and architecture.
    • topics/reference_guide/: API reference and specific features.
    • topics/tutorials/: Step-by-step guides.

assets/

  • build.gradle.kts: A complete Gradle build script template configured for IntelliJ Plugin development (v2.x) with JUnit 5.
  • plugin.xml: A template for the plugin configuration file.
  • settings.gradle.kts: Gradle settings template.
  • gradle.properties: Standard properties for JVM and plugin versions.
  • .gitignore: Standard git ignore file for IntelliJ/Gradle projects.

Recommended Agent Skills

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

titonio/opencode-jb

template-skill

Replace with description of the skill and when Claude should use it.

6 1
Explore
titonio/opencode-jb

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

6 1
Explore
titonio/opencode-jb

internal-comms

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

6 1
Explore
titonio/opencode-jb

mcp-builder

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).

6 1
Explore
titonio/opencode-jb

canvas-design

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

6 1
Explore
titonio/opencode-jb

web-artifacts-builder

Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.

6 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results