AI-HYSYS-Skill

SkillCommunity

A Codex skill for bounded changes to existing Aspen HYSYS cases, with a strict convergence gate. By leoyong1983-spec.

7 starsUpdated 8 weeks agoGitHub data from 5 Nov 2026

At a glance

Type: Skill
Works with: Aspen HYSYS
Tool versions: Aspen HYSYS V14 and V15 (basic smoke tests passed on both)
Operating systems: Windows
Needs a Aspen HYSYS licence: Yes
AI clients documented: Codex
Licence: MIT
Language: Python

What it can do

Checks the Windows, Python, pywin32 and HYSYS COM set-up, and can create and save a small test case to prove the connection.
Helps the agent pick a control route, direct HYSYS COM or a spreadsheet or Aspen Simulation Workbook bridge, then make bounded parameter changes on a working copy.
Requires repeated solve, read-back and save-reopen checks before a case counts as converged, so an idle solver isn't taken as success.
Exports machine-readable results, rearranges the native PFD on a workcopy and helps assemble a review-stage basic process package.

Limitations

Built to take over cases that people have already built and run; the author doesn't claim reliable from-scratch HYSYS model building.
Automatic PFD label placement stops where label ownership can't be proven, which the author found was the case in the V14 and V15 sample views.
Complex flowsheets and plug-ins need checking separately on each version.

Install

git clone https://github.com/leoyong1983-spec/AI-HYSYS-Skill.git
cd AI-HYSYS-Skill

Source: github.com/leoyong1983-spec/AI-HYSYS-Skill#1-clone-the-repository

Copy the repository contents (README.md, SKILL.md, AGENTS.md, agents, references, scripts and CASE) into a Codex skill folder named ai-hysys-basic-package, for example %USERPROFILE%\.codex\skills\ai-hysys-basic-package. The README gives a PowerShell snippet.

Source: github.com/leoyong1983-spec/AI-HYSYS-Skill#2-install-it-as-a-codex-skill

py .\scripts\hysys_readiness_check.py --create-smoke-case

Source: github.com/leoyong1983-spec/AI-HYSYS-Skill#3-use-it-in-a-real-hysys-task

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.