HALCON Vision Script Authoring Skill

Proof of Concept — This skill is under active development and may change significantly.

An Agent Skill for generating, refactoring, running, and reviewing MVTec HALCON vision scripts. It produces HDevelop (.hdev) and HDevelopEVO (.hscript) programs with accurate operator usage, parameter defaults and documentation.

This skill follows the open Agent Skills standard and works with any compatible agent, including Claude Code and OpenAI Codex.

What It Does

• Generates complete, executable scripts in both HDevelop XML (.hdev) and HDevelopEVO plain-text (.hscript) formats
• Selects appropriate HALCON operators with valid parameter ranges and sensible defaults
• Builds structured vision pipelines following a proven workflow: input → ROI → preprocessing → detection → decision
• Creates reusable procedures documented in English by default, plus the user’s language when different and additional existing project languages
• Runs individual procedures and tests with explicit inputs, JSON results, and optional SVG visualization through the Python runner
• Debugs live HDevelop procedures without HDevelop using persistent sessions, stepping, breakpoints, vector inspection, and iconic previews
• Runs complete programs headlessly via hrun or hscriptengine
• Uses installed HALCON documentation — operator references, solution guides, and examples

Prerequisites

• An AI coding agent that supports Agent Skills
• HALCON (or compatible version) installed with HALCONROOT and HALCONEXAMPLES environment variables set
• A valid HALCON runtime license for execution
• For the Python runner/debugger: Python and HALCON Python bindings matching the installed runtime, plus the dependencies below
• For complete-program execution: the selected hrun or hscriptengine executable available on your PATH; neither is required merely to use the Python procedure runner

Install the Python helper dependencies from the skill folder:

python -m pip install -r requirements.txt

This installs the SVG and debug-protocol dependencies, not the HALCON bindings or license. See the Python setup reference for runtime configuration.

Installation

Option A: Using npx skills (multi-agent)

Installs the skill for all supported agents at once (Claude Code, Cursor, Codex, Copilot, Gemini CLI, and more):

npx skills add https://github.com/bertram-eu/halcon-skill.git

Or using GitHub shorthand:

npx skills add bertram-eu/halcon-skill