building-native-image

Build and troubleshoot GraalVM Native Image applications. Use this skill to build Java applications with GraalVM Native Image, configure CLI options, or resolve build or runtime issues.

Quality

73%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./substratevm/skills/building-native-image/SKILL.md

Quality

Discovery

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is functional and well-structured with a clear 'what' and 'when' clause targeting a specific technology niche. Its main weakness is moderate specificity—it could enumerate more concrete actions and include additional trigger terms that users commonly use when working with GraalVM Native Image (e.g., AOT compilation, reflection config, substitutions).

Suggestions

Add more specific concrete actions such as 'configure reflection/serialization metadata', 'set up native-image.properties', 'debug missing class or method errors at build time'.

Include additional natural trigger terms users might say, such as 'native-image', 'AOT compilation', 'ahead-of-time compilation', 'reflection configuration', 'GraalVM build failure', or 'SubstrateVM'.

Dimension	Reasoning	Score
Specificity	Names the domain (GraalVM Native Image) and some actions (build, troubleshoot, configure CLI options, resolve build/runtime issues), but doesn't list highly specific concrete actions like 'configure reflection metadata', 'set up native-image.properties', or 'debug missing class errors'.	2 / 3
Completeness	Clearly answers both 'what' (build and troubleshoot GraalVM Native Image applications) and 'when' ('Use this skill to build Java applications with GraalVM Native Image, configure CLI options, or resolve build or runtime issues'), with explicit trigger guidance.	3 / 3
Trigger Term Quality	Includes relevant keywords like 'GraalVM', 'Native Image', 'Java applications', 'CLI options', 'build', and 'runtime issues', but misses common variations users might say such as 'native-image', 'AOT compilation', 'ahead-of-time', 'reflection configuration', 'substrate VM', or 'GraalVM CE/EE'.	2 / 3
Distinctiveness Conflict Risk	GraalVM Native Image is a very specific niche technology; this description is clearly distinguishable from general Java development skills or other build tool skills, making conflict with other skills unlikely.	3 / 3
	Total	10 / 12 Passed

Implementation

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, concise skill that effectively serves as an overview document pointing to detailed references. Its main weaknesses are the lack of a fully concrete executable example (using a real class name instead of placeholders) and missing validation/verification steps in the build workflow. The progressive disclosure pattern is excellent.

Suggestions

Add a concrete, end-to-end example using a real class name (e.g., HelloWorld.java) so the build commands are fully copy-paste ready.

Add a validation step after the native-image build command, such as checking the exit code or verifying the binary exists (e.g., `ls -la ./app-name` or checking for build errors).

Dimension	Reasoning	Score
Conciseness	The content is lean and efficient. It assumes Claude knows what Java compilation, classpath, and GraalVM are. Every section serves a clear purpose with no unnecessary explanation or padding.	3 / 3
Actionability	The build and run steps include concrete bash commands, but they're not fully copy-paste ready (e.g., `<app-name>` placeholder without a concrete example). The troubleshooting section describes when to consult references but doesn't provide any inline fixes or executable examples.	2 / 3
Workflow Clarity	The build steps are clearly sequenced (compile → build → run) with a fallback for classpath issues. However, there's no validation checkpoint after the build step (e.g., checking for build errors, verifying the binary was created), and the troubleshooting workflow is essentially 'go read another file' without an explicit feedback loop.	2 / 3
Progressive Disclosure	The skill provides a concise overview with well-signaled, one-level-deep references to detailed materials. The reference table at the bottom and inline links to specific reference files make navigation clear and easy.	3 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: oracle/graal
Commit: f2ac60f

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.