graal — Claude Code skill: what it does, how to install
Guides GraalVM Native Image compilation and build-tool setup. Useful when configuring Maven, Gradle, or reflection metadata.
npx skills add oracle/skills --skill graal -a claude-codeWhat graal does
This skill guides your coding assistant through compiling Java applications into standalone native binaries. It routes tasks across four guides covering the native-image CLI, Native Build Tools plugins, reachability metadata, and error diagnostics.
For structured projects, the skill favors build-tool plugins over raw command-line invocations. When native binaries fail, it directs the agent to inspect class initialization timings, heap limits, or missing reflection descriptors.
What it helps with
- Set up Maven or Gradle plugins for native compilation
- Populate
reachability-metadata.jsonfor reflection and dynamic proxies - Resolve runtime exceptions caused by class initialization issues
- Pick CLI optimization and security flags for direct binary compilation
Example prompts for the agent
- Configure native-maven-plugin in my pom.xml to generate an executable binary
- Find out why my GraalVM native binary throws a reflection error at runtime
- Compile a standalone Java file using the native-image CLI tool
How to install graal
1Skills CLI (Vercel)
npx skills add oracle/skills --skill graal -a claude-code2Manually: put the files in place
~/.claude/skills/graal/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/graal/
1Skills CLI (Vercel)
npx skills add oracle/skills --skill graal -a codex2Manually: put the files in place
.agents/skills/graal/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oracle/skills --skill graal -a cursor2Manually: put the files in place
.cursor/skills/graal/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oracle/skills graal2Manually: put the files in place
.github/skills/graal/SKILL.md1Skills CLI (Vercel)
npx skills add oracle/skills --skill graal -a gemini-cli2Platform CLI
gemini skills install https://github.com/oracle/skills --path graalManually: put the files in place
.devin/skills/graal/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oracle/skills --skill graal -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about graal
How to install graal in Claude Code?
Run npx skills add oracle/skills --skill graal -a claude-code in your terminal. This registers the skill at ~/.claude/skills/graal/SKILL.md.
What does the graal skill do?
It gives the coding agent structured routing to build, tune, and debug GraalVM Native Image executables. The instructions cover both build-tool plugins and direct CLI flags.
When should you pick Native Build Tools over the raw CLI?
For projects structured with Maven or Gradle, the skill recommends using Native Build Tools plugins. Raw native-image CLI executions are kept for isolated Java files or direct terminal commands.
