HFSS API Skill

Codex skill for automating ANSYS HFSS through PyAEDT on Windows.

This repository packages a local skill named hfss-pyaedt for:

• checking whether PyAEDT and AEDT/HFSS are available
• creating a minimal HFSS project from the command line
• reopening an existing .aedt project, updating variables, rerunning analysis, and exporting Touchstone

Included Files

• SKILL.md: skill instructions for Codex
• agents/openai.yaml: UI metadata
• scripts/hfss_workflow.py: automation entrypoint
• references/: workflow recipes and environment checklist

Requirements

• Windows
• local ANSYS Electronics Desktop / HFSS installation
• Python with pyaedt installed

Quick Start

Run the environment doctor:

py -3.14 scripts/hfss_workflow.py doctor

Create a minimal project:

py -3.14 scripts/hfss_workflow.py new-box-project `
  --project C:\temp\hfss\demo_box.aedt `
  --design HFSSDesign1 `
  --solution-type DrivenModal `
  --origin 0mm,0mm,0mm `
  --size 10mm,10mm,1mm `
  --create-open-region `
  --setup-name Setup1 `
  --setup-frequency 10GHz `
  --sweep-name Sweep1 `
  --sweep-start 8 `
  --sweep-stop 12 `
  --sweep-count 401

Re-analyze and export Touchstone:

py -3.14 scripts/hfss_workflow.py analyze-project `
  --project C:\temp\hfss\demo_box.aedt `
  --design HFSSDesign1 `
  --setup-name Setup1 `
  --sweep-name Sweep1 `
  --set-variable L=12mm `
  --export-touchstone C:\temp\hfss\demo_box.s2p

Install As A Codex Skill

Copy this folder into your Codex skills directory, or install it from GitHub once published.

Default local skills directory:

%USERPROFILE%\.codex\skills

Recommended final installed folder name:

hfss-pyaedt

Notes

• The first version is intentionally narrow and stable.
• It focuses on environment diagnostics, minimal project creation, and rerun/export workflows.
• Extend scripts/hfss_workflow.py incrementally for metasurface, antenna, or batch sweep workflows.