Agent skill

Example Validation

by aspose-pdf in aspose-pdf/Aspose.PDF-for-Java

Validate Aspose.PDF Java example changes by compiling, running example runners, and checking expected output files.

MITAuto-check passedDocuments & Office

Install Example Validation

skills CLI
$ npx skills add aspose-pdf/Aspose.PDF-for-Java --skill example-validation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aspose-pdf/Aspose.PDF-for-Java example-validation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aspose-pdf/Aspose.PDF-for-Java.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/example-validation .claude/skills/example-validation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
example-validation
GitHub stars
144
Token cost
~628 tokens
SKILL.md length
200 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Validate Aspose.PDF Java example changes by compiling, running example runners, and checking expected output files.

  • Works in 5 steps: Confirm Java toolchain and compile → Run the selected runner if provided → If no runner is provided, run the… → …
  • Editing example classes
  • SKILL.md covers When to Use, Inputs, Procedure and Validation Notes, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Example Validation is an agent skill from aspose-pdf/Aspose.PDF-for-Java. Validate Aspose.PDF Java example changes by compiling, running example runners, and checking expected output files. Use when editing example classes, adding new categories, or reviewing regressions.

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering PDF. It works with Java. The repository describes itself as: Aspose.PDF for Java examples, plugins and showcases. The licence is MIT.

When your agent uses it

  • Editing example classes
  • Adding new categories
  • Reviewing regressions

Example prompts

  • “/example-validation”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Confirm Java toolchain and compile
  2. Run the selected runner if provided
  3. If no runner is provided, run the repository-wide script
  4. Check output artifacts
  5. Summarize validation status

What it can do on your machine

Read from SKILL.md and the folder at commit a983019. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Example Validation loads about 628 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 200 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~628

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aspose-pdf/Aspose.PDF-for-Java at commit a983019, republished under its MIT licence (© aspose-pdf). 200 words, ~628 tokens.

Download SKILL.mdSave it as .claude/skills/example-validation/SKILL.md (or your agent's skills folder).
name
example-validation
description
Validate Aspose.PDF Java example changes by compiling, running example runners, and checking expected output files. Use when editing example classes, adding new categories, or reviewing regressions.
argument-hint
Runner class, license path, expected output files
user-invocable
true

Example Validation Workflow

Use this skill after changing Java examples to confirm they still compile and produce expected output files.

When to Use

  • After modifying files in examples/documentation/src/main/java/com/aspose/pdf/examples
  • After adding a new category runner or operation class
  • Before opening a PR for examples changes

Inputs

  • Runner class (optional): fully qualified class name, for example com.aspose.pdf.examples.basicoperations.BasicOperationsExamples
  • License path (optional): absolute path to Aspose.PDF license file
  • Expected outputs (optional): output filenames relative to examples/documentation/sample-data/<category>/output

Procedure

  1. Confirm Java toolchain and compile:
    • mvn -f examples/documentation/pom.xml clean compile
  2. Run the selected runner if provided:
    • cd examples/documentation
    • mvn -DskipTests exec:java "-Dexec.mainClass=<runner class>"
  3. If no runner is provided, run the repository-wide script:
    • Windows PowerShell:
      • examples/documentation/tools/run-all-examples.ps1
      • examples/documentation/tools/run-all-examples.ps1 -LicensePath "<license path>"
    • Bash:
      • examples/documentation/tools/run-all-examples.sh
      • examples/documentation/tools/run-all-examples.sh --license <license path>
  4. Check output artifacts:
    • Verify expected files exist under examples/documentation/sample-data/<category>/output
    • Flag missing files and list them explicitly
  5. Summarize validation status:
    • compile: pass or fail
    • run: pass or fail
    • outputs: pass or fail
    • blockers and next actions

Validation Notes

  • JDK 25 or newer is required; builds fail on older versions.
  • If no license is provided, examples may run in evaluation mode.
  • initializeDataDir creates directories automatically, so missing folders alone do not prove success.

References

© aspose-pdf, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/example-validation of aspose-pdf/Aspose.PDF-for-Java.

Open the folder on GitHubat commit a983019

Compare with similar skills

Example Validation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Example Validation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Example Validation this skillaspose-pdf/Aspose.PDF-for-Java144—~628Automated safety check: PassMIT
OCR Parser Optimizerlets-mica/mica-ppocr110—~3.2kAutomated safety check: PassApache-2.0
Canvas Ics33X-isdoingreat/canvas-pilot125—~8.8kAutomated safety check: NotesAGPL-3.0
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
GenOffice Document CLIgenspark-ai/genoffice8.9k—~19kAutomated safety check: PassApache-2.0

Similar skills

  • OCR Parser Optimizer

    lets-mica/mica-ppocr

    Optimizes mica-ppocr Java parsers via batch run, failure diagnosis, and LabelMatcher/regex fixes.

    110 GitHub stars~3.2k tokensUpdated 7 days ago
    Documents & OfficeAuto-check passed
  • Canvas Ics33

    X-isdoingreat/canvas-pilot

    Generic code-course handler — programming assignments where the spec lives outside Canvas (instructor's external site, attached PDF, or referenced textbook), starter code is downloaded as a…

    125 GitHub stars~8.8k tokensUpdated 2 mo ago
    Testing & QAAuto-check: notes
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • GenOffice Document CLI

    genspark-ai/genoffice

    Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.

    8.9k GitHub stars~19k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Harness Book Best Practice

    wquguru/harness-books

    Best practices for working on the Harness books repo. An agent skill from wquguru/harness-books.

    3.2k GitHub stars~4.1k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed

Works with

Questions about Example Validation

What does Example Validation do?

Validate Aspose.PDF Java example changes by compiling, running example runners, and checking expected output files. PDF-for-Java.PDF Java example changes by compiling, running example runners, and checking expected output files.

When should I use Example Validation?

Example Validation fits situations like: editing example classes; adding new categories; reviewing regressions.

How do I install Example Validation in Claude Code?

Run `npx skills add aspose-pdf/Aspose.PDF-for-Java --skill example-validation -a claude-code`. Or copy the skill folder (.github/skills/example-validation in aspose-pdf/Aspose.PDF-for-Java) into .claude/skills/example-validation in your project. Claude Code loads it when a task matches its description.

How do I install Example Validation in Codex?

Run `npx skills add aspose-pdf/Aspose.PDF-for-Java --skill example-validation -a codex`. Or copy the skill folder (.github/skills/example-validation in aspose-pdf/Aspose.PDF-for-Java) into .agents/skills/example-validation in your project. Codex loads it when a task matches its description.

Can I use Example Validation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aspose-pdf/Aspose.PDF-for-Java --skill example-validation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/example-validation, .gemini/skills/example-validation, .github/skills/example-validation and .opencode/skills/example-validation in your project.

What does Example Validation need to run?

SKILL.md names no scripts, command-line tools or credentials: Example Validation is instructions for the agent only.

Does Example Validation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Example Validation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Example Validation use?

Example Validation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Example Validation use?

About 628 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Example Validation?

Skills that share tags, products or a category with Example Validation: OCR Parser Optimizer (lets-mica/mica-ppocr, 110 stars), Canvas Ics33 (X-isdoingreat/canvas-pilot, 125 stars), Markitdown (ImCa0/just-laws, 781 stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Example Validation?

aspose-pdf (a GitHub organization) maintains it in aspose-pdf/Aspose.PDF-for-Java, which has 144 GitHub stars. The repository was last updated on September 10, 2026.

Source: aspose-pdf/Aspose.PDF-for-Java on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.