About graal
A skill collection for building, configuring, and troubleshooting GraalVM Native Image applications with Maven, Gradle, or the CLI. It separates build-tool guidance, metadata configuration, and troubleshooting into focused references.
Key features
- 01Native Image CLI build guidance
- 02Maven and Gradle integration
- 03Reachability metadata guidance
- 04Build and runtime troubleshooting
Use cases
- 01Build a Java class as a native image
- 02Configure Native Image in a Maven or Gradle project
- 03Resolve missing reflection or resource metadata
- 04Investigate build or runtime failures
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ oracle/ skills --skill graalAfter installing, type/graalin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
native-image/build-native-image.mdnative-build-tools.mdreachability-metadata.mdtroubleshooting.mdDetails
From the project READMEOracle Graal Skills
Use this domain to build, configure, and troubleshoot GraalVM Native Image applications with Maven, Gradle, or the CLI.
How to Use This Domain
- Start with the routing table below.
- Read only the specific Native Image file needed for the task.
- Prefer Native Build Tools for Maven or Gradle projects. Use the raw
native-imageworkflow for simple Java files or direct CLI usage.
Directory Structure
graal/
|-- SKILL.md
`-- native-image/
|-- build-native-image.md
|-- native-build-tools.md
|-- reachability-metadata.md
`-- troubleshooting.md
Category Routing
| Topic | File |
|---|---|
native-image CLI builds, options, classpath, modules, output names, binary type, optimization, URL protocols, monitoring, security | graal/native-image/build-native-image.md |
Maven native-maven-plugin, Gradle org.graalvm.buildtools.native, build-tool tasks, plugin options, and native test routing | graal/native-image/native-build-tools.md |
Missing reflection, JNI, resources, resource bundles, serialization, dynamic proxies, conditional metadata, and reachability-metadata.json layout | graal/native-image/reachability-metadata.md |
| Build failures, runtime failures, missing metadata symptoms, class initialization issues, memory issues, diagnostics, Maven activation issues, and where to route fixes | graal/native-image/troubleshooting.md |
Key Starting Points
graal/native-image/build-native-image.mdgraal/native-image/native-build-tools.mdgraal/native-image/reachability-metadata.mdgraal/native-image/troubleshooting.md
Common Multi-Step Flows
| Task | Recommended Sequence |
|---|---|
| Build a Java class with Native Image | native-image/build-native-image.md |
| Configure a Maven or Gradle project for Native Image | native-image/native-build-tools.md -> native-image/build-native-image.md for flags |
| Fix missing reflection, JNI, proxy, resource, bundle, or serialization metadata | native-image/reachability-metadata.md |
| Diagnose build failures or runtime behavior differences | native-image/troubleshooting.md -> native-image/build-native-image.md -> native-image/reachability-metadata.md if metadata is involved |
Sources
- https://github.com/oracle/graal/tree/master/substratevm/skills/building-native-image
- https://github.com/oracle/graal/tree/master/substratevm/skills/build-native-image-maven
- https://github.com/oracle/graal/tree/master/substratevm/skills/build-native-image-gradle
- https://www.graalvm.org/latest/reference-manual/native-image/
Comments
Markdown supported