Graal
DevelopmentgraalGraal is an Agent Skill for development published in the oracle/skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Build, configure, and troubleshoot GraalVM Native Image applications. Use this skill for native-image CLI builds, Maven or Gradle Native Build Tools, reachability metadata, and build or run time issue diagnosis.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/oracle/skills/blob/HEAD/graal/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/graal, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Oracle 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/