Guides › LLM Setup

Using AI Tools with PH-Tools Docs

AI coding assistants (ChatGPT, Cursor, Claude Code, Copilot, etc.) work better when they have domain-specific reference material — the same way you'd hand a new team member the WUFI manual before asking them to QC a model. This page explains how to give your AI tool structured knowledge about WUFI-Passive XML files, PHX model classes, and PHPP field mappings.

LLM-Ready Reference Documents

We maintain a set of reference documents formatted specifically for AI tools. These are plain markdown files — no HTML, no front-matter — containing schema maps, field dictionaries, and code references that help an AI understand PH-Tools data structures.

These docs are hosted at stable URLs on this site. When we update a schema map or fix a field mapping, anyone using these URLs gets the current version automatically.

LLM-ready · Fetch this doc

WUFI-Passive XML schema reference — structure map, field dictionary, and unit conversions.

GET https://docs.passivehousetools.com/llm/phx/reference/wufi-xml-schema.md
LLM-ready · Fetch this doc

PHX model reference — object graph, module map, design patterns, and testing conventions.

GET https://docs.passivehousetools.com/llm/phx/reference/phx-model-reference.md
LLM-ready · Fetch this doc

PHPP field mapping — cell-level locator map for reading and writing PHPP 10.6 worksheets.

GET https://docs.passivehousetools.com/llm/phx/reference/phpp-field-mapping.md

Using These Docs with Any AI Tool

The reference docs above work with any AI tool that can read a URL or accept pasted text. Here are some common approaches:

Tool How to use
ChatGPT Paste the reference doc URL into your prompt — ChatGPT will fetch and read it. Or copy the markdown content directly into your message.
Cursor / Windsurf Add the reference doc URL as context using @URL, or save the markdown file locally and add it with @file.
GitHub Copilot Chat Paste the reference doc content into the chat, or save it locally in your project and reference it.
Claude Code Use WebFetch to pull the doc into context, or install a pre-built skill (see below) that does this automatically.
Any other tool Copy the markdown content from the URL and paste it into your AI conversation as context.

The key idea is the same regardless of tool: give the AI the reference material before asking it to work with your WUFI XML, PHX code, or PHPP data. Think of it like handing someone the spec sheet before asking them to review a submittal.

Discovery Endpoints

If you want to explore what reference docs are available, or point an AI tool at a starting index, these entry points help:

URL Purpose
/llm-instructions.md Navigation guide — URL patterns, direct links to common docs
/llms.txt Standard LLM site index (llms.txt convention)
/site-index.json Structured catalog of all pages with metadata and llm_use_when fields

Claude Code Skills

If you use Claude Code, you can install skills that automatically load the right reference doc when a relevant task comes up. This section is Claude Code–specific — if you use a different AI tool, the reference docs and general guidance above are all you need.

How Skills Work

A skill is a markdown file that Claude Code loads when a task matches its trigger description. Each skill contains a compact instruction set plus a WebFetch command that pulls the full reference doc from this site at runtime.

The flow looks like this:

  1. You invoke a skill (e.g., ask Claude about a WUFI XML file)
  2. Claude loads the skill's SKILL.md — a ~100-line instruction set with quick-reference tables
  3. The skill tells Claude to WebFetch the full reference doc from docs.passivehousetools.com/llm/...
  4. Claude now has the complete schema reference in context for the rest of the task

Because the reference docs are hosted here, they stay current — when we update a schema map or fix a field mapping, every skill user gets the fix on their next task. No reinstall, no version mismatch.

Available Skills

wufi-xml Download SKILL.md

Navigate, verify, and extract data from WUFI-Passive XML model files. Use for QA/QC, certification review, value verification, and data extraction.

Fetches: wufi-xml-schema.md
phx-model Download SKILL.md

Navigate, understand, modify, and test PHX model classes. Use when working with PhxProject, PhxVariant, PhxBuilding, and the full PHX object graph.

Fetches: phx-model-reference.md
phius-certification Download SKILL.md

Navigate Phius certification project folders, parse the Feedback Form, track review status, and cross-reference documentation. Use when managing certification review cycles or locating supporting documents.

Fetches: folder-map.md, feedback-form-guide.md

Installation

Skills live in your Claude Code skills directory. Each skill is a folder containing a SKILL.md file.

Option A: Manual download

  1. Download the skill file using the link above (or from the URLs below)
  2. Create the skill directory: mkdir -p ~/.claude/skills/wufi-xml
  3. Move the downloaded file: mv wufi-xml.md ~/.claude/skills/wufi-xml/SKILL.md
  4. Repeat for each skill you want

Option B: One-liner

# Install wufi-xml skill
mkdir -p ~/.claude/skills/wufi-xml && \
  curl -sL https://docs.passivehousetools.com/skills/wufi-xml.md \
  -o ~/.claude/skills/wufi-xml/SKILL.md

# Install phx-model skill
mkdir -p ~/.claude/skills/phx-model && \
  curl -sL https://docs.passivehousetools.com/skills/phx-model.md \
  -o ~/.claude/skills/phx-model/SKILL.md

# Install phius-certification skill
mkdir -p ~/.claude/skills/phius-certification && \
  curl -sL https://docs.passivehousetools.com/skills/phius-certification.md \
  -o ~/.claude/skills/phius-certification/SKILL.md

Verify

After installation, the skill should appear in Claude Code's skill list. You can verify by running ls ~/.claude/skills/ — you should see the skill directories.

To test, start a Claude Code session and ask it to look at a WUFI XML file or describe a PHX model class. It should automatically load the skill and fetch the reference doc.