Grasshopper Skill

A local agent skill containing Rhino Grasshopper component documentation, organized for LLM/agent context management.

Source data comes from the public Grasshopper documentation site and backend API:

• https://www.rhino3d.com/docs/grasshopper
• https://ghdocs-backend.rhino3d.com/content/get_search_list/grasshopper/
• https://ghdocs-backend.rhino3d.com/content/get_component_from_name/{Category}/{Component}/

The generated skill lives in grasshopper-components/. Its SKILL.md provides a compact routing index; group references contain the component purpose, inputs, and outputs. Only components with substantial extra prose get individual detail files, keeping the skill below Codex's 200-file limit.

Development

Download the raw Grasshopper archive:

python3 download_ghdocs.py --out ghdocs_dump --toolset grasshopper

This fetches the public backend JSON for all components, preserves the raw structured data, downloads icons and documentation images, and writes everything into ghdocs_dump/.

Generate the agent skill from the archive:

python3 build_grasshopper_skill.py --archive ghdocs_dump --out grasshopper-components --force

This creates the skill directory, grouped Markdown references, selected per-component detail files, and compact normalized JSONL data. User-facing docs intentionally omit images, videos, GUIDs, backend endpoints, and archive metadata.

ghdocs_dump/ is intentionally ignored by git because it is a large reproducible source archive.

Release

Create and upload a GitHub release asset locally:

scripts/release.sh v0.1.0

The script zips grasshopper-components/ and uses the GitHub CLI (gh) to create or update a release asset.