Agent Skills

ShapeDiver provides a set of open-source Agent Skills that give AI coding assistants expert-level knowledge about building ShapeDiver 3D configurators. When installed, these skills allow tools like GitHub Copilot, Claude Code, Cursor, and many others to generate correct, production-ready ShapeDiver integration code without you having to look up API details manually.

What are Agent Skills?

Agent Skills are a standardized way to provide specialized instructions to AI coding assistants. They work through a mechanism called progressive disclosure: your AI assistant knows what skills are available at all times, but only loads the detailed instructions when they become relevant to your task.

In practice, this means that once you install the ShapeDiver skills, your AI assistant will automatically recognize when you are working on a ShapeDiver project and provide accurate guidance.

Available Skills

The following skills are included in the shapediver/agent-skills repository:

Skill	Description
shapediver-router	Entry point for all ShapeDiver projects. Identifies integration strategy and gathers credentials.
shapediver-viewer	Viewer V3 API for custom 3D configurators, including interaction features (CDN, NPM, React).
shapediver-appbuilder	App Builder router — guides to iframe, theme, or fork strategy.
shapediver-appbuilder-iframe	App Builder iframe embedding — fastest path, zero code.
shapediver-appbuilder-theme	App Builder with optional custom theme (colors, fonts, logo).
shapediver-appbuilder-fork	Fork the open-source App Builder React app for custom components.
shapediver-headless	Headless/server-side integration via the Geometry SDK.

How the skills work together

When you ask your AI assistant to help with a ShapeDiver project, the router skill activates first. It asks a few clarifying questions to understand your needs and collects the credentials required to work with your model. Based on your answers, it hands off to the appropriate implementation skill.

For example:

If you say "I want to embed my configurator on my website with no code," the router directs to the App Builder iframe skill.
If you say "I need custom drag-and-drop interactions in my 3D viewer," the router directs to the Viewer skill.
If you say "I want to trigger exports from my backend," the router directs to the Headless skill.

This ensures you always get relevant guidance without being overwhelmed by documentation for features you do not need.

Installation

Option 1: GitHub CLI (recommended)

BASH

# Interactive — choose which skills to install and for which agent
gh skill install shapediver/agent-skills

Requires the GitHub CLI with gh skill support. This launches an interactive prompt where you choose which skills to install and which AI assistant you are using. We recommend to always install all skills.

Option 2: Manual

If you prefer not to use the GitHub CLI, you can clone the repository and copy the skill folders into your agent's skills directory:

BASH

# Clone the repository
git clone https://github.com/shapediver/agent-skills.git

# Ensure the target directory exists
mkdir -p .agents/skills

# Copy the skill folders directly into your project
cp -r agent-skills/skills/* .agents/skills/

# Clean up the cloned repository folder (optional but recommended)
rm -rf agent-skills

The exact directory depends on which AI assistant you are using:

Agent	Project scope	User scope
GitHub Copilot	`.github/skills/` or `.agents/skills/`	`~/.copilot/skills/` or `~/.agents/skills/`
Claude Code	`.claude/skills/` or `.agents/skills/`	`~/.claude/skills/`
Cursor	`.cursor/skills/` or `.agents/skills/`	`~/.cursor/skills/`
Others	`.agents/skills/`	`~/.agents/skills/`

Project scope means the skills are available only within a specific project directory. User scope means they are available across all your projects.

Supported AI assistants

The skills follow the open Agent Skills specification and are compatible with any AI coding assistant that supports the standard. This includes GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Roo Code, Amp, Goose, and many more.

Updating skills

To update to the latest version of the skills:

BASH

gh skill update --all

Or, if you installed manually, repeat the clone and copy steps described above.