About

Imported from kinhluan/rules-quarkus-skills (.agent-skills/graalvm-expert/SKILL.md). Install upstream with npx skills add kinhluan/rules-quarkus-skills --skill graalvm-expert. Copyright stays with the author.

graalvm-expert

Name: graalvm-expert
Author: kinhluan

Keyword: graalvm | Platforms: gemini,claude,codex

High-Performance Polyglot & Native VM Expert Skill - Specialized in GraalVM AOT (Ahead-of-Time) compilation.

Core Mandates

AOT Mindset: Understand that Native Image has a "Closed-world assumption" (all bytecode must be known at build time).
Reflection Discipline: Mandate reflection-config.json for any dynamic class loading or reflection usage.
Initialization Policy: Differentiate between Build-time initialization (faster startup, smaller image) and Runtime initialization (safer for classes with side effects).
Polyglot Strategy: Leverage GraalVM SDK for high-performance interoperability between Java, JS, Python, and Ruby.

Native Image Mastery

Native Image Agent: Using java -agentlib:native-image-agent to automatically generate configuration files.
Resource Management: Config for resource-config.json to include static assets in the native binary.
Dynamic Proxy: Configuring proxy-config.json for Java dynamic proxies.
Substrate VM: Understanding memory management and GC options (G1 vs Serial) in native binaries.

GraalVM + Build Systems

Maven/Gradle: Using the GraalVM Native Build Tools plugins.
Bazel Integration: Configuring rules_graalvm and toolchains for hermetic native builds.
Quarkus Native: Troubleshooting Quarkus-specific native image failures (often related to extensions or transitive libraries).

Optimization & Performance

PGO (Profile-Guided Optimization): Collecting profiles from JIT runs to optimize AOT binaries.
Graal JIT: Using Graal as a replacement for C2 compiler in standard JVM mode for better performance in modern Java.
Static Analysis: Interpreting GraalVM build-time reports (reachability analysis).

Expert Tips

Always check reflect-config.json if you get ClassNotFoundException in a native binary.
Prefer quarkus.native.additional-build-args for passing low-level GraalVM flags.
Use --trace-class-initialization to debug complex initialization order issues.

🌐 GraalVM Deep Dives

Directive: Use web_fetch to find specific configuration flags or reflection-config.json syntax if a native build fails or requires optimization.

Native Image Agent: GraalVM Agent Guide - Automating metadata collection.
Reflection Config: Reflection Config Reference - Manual reflection configuration.
Dynamic Proxy: Dynamic Proxy metadata - Handling interface-based proxies.
Static vs Runtime Init: Class Initialization in Native Image - Debugging --initialize-at-build-time.

References

Skill Interoperability

The graalvm-expert 🚀 skill provides the native runtime and AOT compilation expertise for:

quarkus-expert ⚡: Enables building Native Images for Quarkus applications. It depends on java-expert ☕ for understanding reflection and resource configuration.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/kinhluan-rules-quarkus-skills-graalvm-expert/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

kinhluan-rules-quarkus-skills-graalvm-expert.ocm.jsonjson

{
  "ocm": "1",
  "id": "kinhluan-rules-quarkus-skills-graalvm-expert",
  "kind": "skill",
  "name": "graalvm-expert",
  "description": "Expert knowledge for GraalVM, Native Image (AOT), Polyglot runtime, and reflection/resource configuration. Use for native compilation and multi-language JVM questions.",
  "publisher": "kinhluan",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "graalvm",
      "native-image",
      "aot",
      "polyglot",
      "optimization",
      "jvm",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Expert knowledge for GraalVM, Native Image (AOT), Polyglot runtime, and reflection/resource configuration. Use for native compilation and multi-language JVM questions."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/kinhluan/rules-quarkus-skills",
      "path": ".agent-skills/graalvm-expert/SKILL.md",
      "ref": "9e87d74345f6f82557e9bfe4c826d08693e34196",
      "url": "https://github.com/kinhluan/rules-quarkus-skills/blob/9e87d74345f6f82557e9bfe4c826d08693e34196/.agent-skills/graalvm-expert/SKILL.md",
      "key": "kinhluan/rules-quarkus-skills/.agent-skills/graalvm-expert/SKILL.md"
    }
  },
  "instructions": "# graalvm-expert\n\n> Keyword: graalvm | Platforms: gemini,claude,codex\n\nHigh-Performance Polyglot & Native VM Expert Skill - Specialized in GraalVM AOT (Ahead-of-Time) compilation.\n\n## Core Mandates\n\n- **AOT Mindset:** Understand that Native Image has a \"Closed-world assumption\" (all bytecode must be known at build time).\n- **Reflection Discipline:** Mandate `reflection-config.json` for any dynamic class loading or reflection usage.\n- **Initialization Policy:** Differentiate between **Build-time initialization** (faster startup, smaller image) and **Runtime initialization** (safer for classes w",
  "cost": {
    "context_tokens": 893
  }
}

Fetch it by URL: GET /api/v1/registry/kinhluan-rules-quarkus-skills-graalvm-expert/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.