From idfkit
EnergyPlus modeling conventions, naming patterns, and best practices with idfkit. Loaded automatically when working with IDF, epJSON, or idfkit Python code.
How this skill is triggered — by the user, by Claude, or both
Slash command
/idfkit:idf-conventions**/*.idf**/*.epJSON**/*.epjson**/*.pyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill assumes the idfkit MCP server is available. Don't rely on a memorized tool count — consult
This skill assumes the idfkit MCP server is available. Don't rely on a memorized tool count — consult the live tool list and the server's own startup instructions for the authoritative set. The tools span schema introspection, model read/write, validation + integrity, simulation + analysis, weather, documentation, and version migration.
Structured state is exposed as read-only idfkit://… resources you can read at any time, including:
idfkit://model/summary — version, zones, object counts, and groups for the loaded modelidfkit://model/objects/{object_type}/{name} — all field values for a specific objectidfkit://model/references/{name} — bidirectional references (who references this object and what it references)idfkit://schema/{object_type} — full field schema for an object typeidfkit://docs/{object_type} — I/O Reference, Engineering Reference, and search URLsidfkit://simulation/results — energy metrics, errors, and tables from the last simulationidfkit://simulation/peak-loads — peak heating/cooling load decomposition with QA flagsidfkit://simulation/report — full tabular simulation report organized by section and tableidfkit://migration/report — per-step transition output and structural diff after migrate_modelThe server may expose more — treat its live instructions as authoritative rather than this list.
direction_of_relative_north, ceiling_heightfields parameterBuildingSurface:Detailed takes vertices: [{vertex_x_coordinate, vertex_y_coordinate, vertex_z_coordinate}, …]. (Flat numbered keys like vertex_1_x_coordinate are a deprecated compat shim that emits warnings — don't use them.) Check describe_object_type's extensible_group for the exact key and item fields.describe_object_type before creating objects — know valid fields, constraints, and defaultsbatch_add_objects for multiple objects — minimizes round-trips vs individual add_object callsget_available_references for reference fields — ensures valid values (e.g., zone names, schedule names)validate_model to catch schema violations and dangling referencescheck_model_integrity before simulation — catches domain-level issues (zones without surfaces, orphan schedules, boundary mismatches, HVAC reference errors)remove_object blocks if the object is referenced (use force=True only when intentional)rename_object instead of remove+add — it automatically updates all referencesidfkit://model/objects/{type}/{name} to inspect objects and idfkit://model/references/{name} to check referencesLATEST_VERSIONidfkit://docs/{object_type} resource to get docs.idfkit.com URLs for any object typesearch_docs to find documentation by keywordget_doc_section to read full documentation sectionsnpx claudepluginhub idfkit/idfkit-plugin --plugin idfkitCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.