Grasshopper Plugin Development

Codex-native skill for designing, implementing, packaging, and releasing compiled Rhino 8 and Grasshopper plugins in C#.

This repository is for .gha plugin development workflows, not for code pasted into Grasshopper script components.

What this skill helps with

• designing plugin architecture for RhinoCommon and Grasshopper
• keeping business logic out of GH_Component UI classes
• structuring repos with clean layers such as components, services, helpers, and core utilities
• setting up build and debug workflows for Rhino 8
• preparing Yak and Rhino Package Manager releases
• reviewing manifest.yml, versioning, and packaging assumptions
• preserving stricter shared-repo rules when working in team repositories

Scope boundary

Use this repository when the task is about:

• compiled Grasshopper plugins
• Rhino 8 plugin architecture
• .gha packaging
• Yak and Package Manager publishing
• release workflow and repo structure

Do not use it for:

• C# Script or Python Script nodes inside Grasshopper
• RunScript(...) generation
• copy-paste script-component code

For script nodes, use grasshopper-script-nodes.

What's inside

• SKILL.md - main Codex skill instructions
• agents/openai.yaml - Codex UI metadata
• references/architecture-and-coding.md - layered architecture and code standards
• references/build-release-and-yak.md - build, release, and packaging workflow
• references/official-rhino-yak-notes.md - official Rhino and Yak notes used as source-of-truth guidance
• scripts/check_skill_md.py - basic validation for skill frontmatter and body presence
• scripts/inspect_skill_repo.py - quick structure check for the repository
• assets/social-preview.png - prepared social preview asset for the repository

Source strategy

This skill is based on two inputs:

• practical repository standards derived from INDToolsUpdate
• official Rhino developer guidance for Rhino 8, .NET Core, Yak packaging, and Package Manager workflows

Install in Codex

Copy or clone this repository into your local Codex skills directory:

• Windows: C:\Users\<you>\.codex\skills\grasshopper-plugin-development

Then restart Codex.

Typical prompts

• "Create a Rhino 8 Grasshopper plugin architecture"
• "Design a .gha plugin with services and shared utilities"
• "Prepare a Yak release workflow for this Grasshopper plugin"
• "Review this manifest.yml and package structure"
• "Refactor this plugin repo to keep business logic out of components"

Local validation

python scripts/check_skill_md.py SKILL.md
python scripts/inspect_skill_repo.py .

License

MIT. See LICENSE.txt.