houdini-cli

houdini-cli is a skill for Claude Code, Codex from chordee/houdini-tools. It costs 47 tokens per session (721 once invoked), scanned A, original, MIT.

A guide for using Houdini's command-line programs to inspect 3D geometry, convert files, render scenes, and run Houdini Python scripts.

In plain words
What is it for?
Inspecting geometry files, converting formats, batch-rendering Houdini or USD scenes, and running Houdini scripts.
Why use it?
It explains how to find the Houdini installation and use the right command-line tool for each job.

Skill for Claude CodeCodex

Part of the houdini-tools plugin — 6 skills, 1 MCP server shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/chordee/houdini-tools/houdini-cli
Any agent
npx skills add chordee/houdini-tools --skill houdini-cli
Clone the repo
git clone --depth 1 https://github.com/chordee/houdini-tools

Made for: Claude Code, Codex.

Or install houdini-tools, the plugin that ships this one along with the rest of its 6 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for houdini-cli

README.md
[![agentmods](https://agentmods.dev/badge/skills/chordee/houdini-tools/houdini-cli.svg)](https://agentmods.dev/skills/chordee/houdini-tools/houdini-cli)
Your own site
<a href="https://agentmods.dev/skills/chordee/houdini-tools/houdini-cli"><img src="https://agentmods.dev/badge/skills/chordee/houdini-tools/houdini-cli.svg" alt="Measured on agentmods" height="20"></a>
Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 721 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00047 $0.00721
Opus 5 $0.00023 $0.00360
Sonnet 5 $0.00009 $0.00144
Haiku 4.5 $0.00005 $0.00072

Measured 5d ago against content hash 704d6e7f162b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

houdini-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/houdini-cli/SKILL.md · 53 lines

How it starts

The opening of the file, as written. The whole thing — 53 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Houdini CLI

This skill provides the ability to interact with Houdini's command-line tools.

Environment Setup

Before running any Houdini tool, you must first locate the Houdini installation path and its bin directory.

  1. Locate Houdini: Use the houdini-locator skill to obtain the install path (HFS) and bin directory (HBIN).

  2. Run a tool: Prefix the tool name with the HBIN path, e.g. in PowerShell use & "<HBIN>\ginfo.exe" <args>.

Common Workflows

Inspect Geometry

Use ginfo to inspect geometry files such as .bgeo, .bgeo.sc, and .obj.

  • Example: & "<HBIN>\ginfo.exe" -v my_geo.bgeo.sc

Convert Geometry Formats

Use gconvert to convert files between different formats.

  • Example: & "<HBIN>\gconvert.exe" input.bgeo.sc output.obj

Render HIP Files

Use hrender for batch rendering.

  • Example: & "<HBIN>\hrender.exe" -d /out/mantra1 -f 1 -e 10 myscene.hip

USD Render with husk

Use husk to render a .usd/.usda/.usdc stage via a Hydra delegate (Karma by default).

  • Example: & "<HBIN>\husk.exe" --make-output-path -f 1 -n 10 -o /render/out.$F4.exr scene.usd (-n 10 = frame count, renders frames 1–10)
  • Pick a delegate with -R (e.g. -R HdArnoldRendererPlugin) and a specific RenderSettings with --settings /Render/rendersettings.
  • See husk.md for the full flag list (frame range, output overrides, purpose/complexity, verbosity, threading, etc.).

USD Preview Render with usdrecord

Use usdrecord for quick USD previews via Pixar's reference USD renderer (Storm by default; Karma CPU/XPU and Houdini GL also available). Invoke through hython so Houdini's libraries load correctly.

  • Example: & "<HBIN>\hython.exe" "<HBIN>\usdrecord" --renderer Storm -w 1280 scene.usd preview.png
  • Sequences require a frame placeholder in the output path (e.g. out.####.exr) and --frames 1:100.
  • See usdrecord.md for the full flag list and troubleshooting.

Run Python Scripts

Use hython to run scripts with access to the hou module.

  • Example: & "<HBIN>\hython.exe" process_geo.py

Read the full file on GitHub · 53 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 53 lines · 47 tokens per session scan A 704d6e7f162b

Subscribe to this mod's changes

houdini-cli is a skill published in the GitHub repository chordee/houdini-tools (5 stars, last pushed 6d ago), licensed MIT. It adds 47 tokens to every session and 721 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

spec-kitty-charter-doctrine

Run charter interview, generation, context, and sync workflows for project governance in Spec Kitty 3.x. Access doctrine artifacts programmatically via DoctrineService. Resolve agent profiles. Load action-scoped governance context iteratively, not all at once. Triggers: "interview for charter", "generate charter"…

Priivacy-ai/spec-kitty · 135 tokens

mongodb-query-optimizer

Help with MongoDB query optimization and indexing. Use only when the user asks for optimization or performance: "How do I optimize this query?", "How do I index this?", "Why is this query slow?", "Can you fix my slow queries?", "What are the slow queries on my cluster?", etc. Do not invoke for general MongoDB query…

fcakyon/claude-codex-settings · 98 tokens

polar-local-environment

This skill should be used when setting up or managing Polar local development environment with Docker.

fcakyon/claude-codex-settings · 22 tokens

neo4j-modeling-skill

Design, review, and refactor Neo4j graph data models. Use when choosing node labels vs relationship types vs properties, migrating relational/document schemas to graph, detecting anti-patterns (generic labels, supernodes, missing constraints), designing intermediate nodes for n-ary relationships, enforcing schema with…

neo4j-contrib/neo4j-skills · 152 tokens

lov-article-creator

统一创建、改写、品牌化或忠实转载微信公众号文章包:正文写作调用唯一文风与作者性能力,离线完成结构、品牌、封面、4:3 首图、来源与质量验收。Use when asked to write, brand, audit, or faithfully repost a WeChat article package.

lovstudio/skills · 75 tokens

lov-repo2docs

Turn any folder of source material — a code repository, a pile of articles, a mixed knowledge dump with images — into a professional, polished Fumadocs (Next.js) documentation website, then deploy it to https://{product-id}.example.com/docs. Works by reading the folder one unit at a time and incrementally growing and…

lovstudio/skills · 186 tokens