Speckle Data Platform — Claude Skill Package

25 deterministic Claude AI skills for Speckle Data Platform — the open-source data infrastructure for AEC (Architecture, Engineering, Construction). Covers the full Speckle ecosystem: object model, GraphQL API, Python and C# SDKs, connectors (Revit, Rhino, Grasshopper, Blender, AutoCAD, Tekla), viewer, Automate, and data federation.

Built on the Agent Skills open standard.

---

Why This Exists

Without skills, Claude lacks context about Speckle's transport architecture, detached object references, and connector-specific patterns:

# Wrong — sends flat list without Base wrapper, breaks viewer
operations.send(wall_objects, [transport])

With this skill package, Claude produces correct Speckle patterns:

# Correct — wraps in Base with detached "@" prefix for viewer compatibility
root = Base()
root["@walls"] = wall_objects
obj_id = operations.send(root, [transport])

---

What's Inside

Category	Count	Purpose
core/	3	Object model, transport system, API fundamentals
syntax/	4	Base objects, GraphQL queries, webhooks, Automate syntax
impl/	13	SDK implementations, connectors, viewer, federation, versioning
errors/	3	Transport errors, conversion errors, authentication errors
agents/	2	Data validator, model coordinator
Total	25

Skill Catalog

Core (3 skills)

Skill	Description
speckle-core-object-model	Speckle's Base object, hashing, detached properties, dynamic members
speckle-core-transport	Transport architecture: ServerTransport, SQLiteTransport, MemoryTransport
speckle-core-api	REST and GraphQL API fundamentals, authentication, rate limits

Syntax (4 skills)

Skill	Description
speckle-syntax-base-objects	Creating and composing Base objects, property conventions, serialization
speckle-syntax-graphql	GraphQL query patterns for streams, commits, branches, objects
speckle-syntax-webhooks	Webhook configuration, payload structure, event types, retry logic
speckle-syntax-automate	Automate function syntax, triggers, inputs schema, result reporting

Implementation (13 skills)

Skill	Description
speckle-impl-python-sdk	SpecklePy: client setup, send/receive, operations, subscriptions
speckle-impl-sharp-sdk	Speckle.Sdk (C#): client, transports, serialization, .NET integration
speckle-impl-connectors-overview	Connector architecture, mapping strategy, shared patterns across all connectors
speckle-impl-revit	Revit connector: element mapping, family handling, parameter conversion
speckle-impl-rhino-grasshopper	Rhino and Grasshopper connectors: geometry conversion, component usage
speckle-impl-blender	Blender connector: mesh/curve conversion, collections, custom properties
speckle-impl-autocad-civil3d	AutoCAD and Civil3D connectors: entity mapping, alignment handling
speckle-impl-tekla	Tekla Structures connector: model object mapping, reinforcement, assemblies
speckle-impl-powerbi	Power BI connector: data extraction, stream queries, dashboard integration
speckle-impl-viewer	@speckle/viewer: embedding, filtering, coloring, extensions, interactions
speckle-impl-automate-functions	Building Automate functions: project structure, testing, deployment
speckle-impl-federation	Cross-model data federation: multi-stream coordination, object references
speckle-impl-versioning	Version management: commits, branches, diffing, history traversal

Errors (3 skills)

Skill	Description
speckle-errors-transport	Diagnosing transport failures: timeouts, network errors, object size limits
speckle-errors-conversion	Conversion error patterns: geometry loss, unsupported types, fallback strategies
speckle-errors-auth	Authentication and authorization errors: token expiry, scope issues, server config

Agents (2 skills)

Skill	Description
speckle-agents-data-validator	Validates Speckle data integrity: schema checks, reference resolution, property completeness
speckle-agents-model-coordinator	Orchestrates multi-model workflows: cross-discipline coordination, clash detection setup

Installation

Claude Code

# Option 1: Clone the full package
git clone https://github.com/OpenAEC-Foundation/Speckle-Claude-Skill-Package.git
cp -r Speckle-Claude-Skill-Package/skills/source/ ~/.claude/skills/speckle/

# Option 2: Add as git submodule
git submodule add https://github.com/OpenAEC-Foundation/Speckle-Claude-Skill-Package.git .claude/skills/speckle

Claude.ai (Web)

Upload individual SKILL.md files as project knowledge.

Quick Start

After installation, skills activate automatically based on context:

• Send data to Speckle — ask Claude to send objects to a stream -> activates speckle-impl-python-sdk + speckle-core-transport
• Query the API — write a GraphQL query -> activates speckle-syntax-graphql + speckle-core-api
• Build an Automate function — create a Speckle Automate function -> activates speckle-impl-automate-functions + speckle-syntax-automate
• Debug auth errors — paste a 401/403 error -> activates speckle-errors-auth
• Federate models — coordinate data across streams -> activates speckle-impl-federation + speckle-agents-model-coordinator

MCP Server

This package includes a custom MCP server with 13 tools for direct Speckle API interaction. Add to your .mcp.json:

{
  "mcpServers": {
    "speckle": {
      "command": "node",
      "args": ["./mcp-server/build/index.js"],
      "env": {
        "SPECKLE_TOKEN": "your-personal-access-token"
      }
    }
  }
}

Tools: speckle_server_info, speckle_list_projects, speckle_get_project, speckle_search_projects, speckle_create_project, speckle_list_models, speckle_get_model, speckle_create_model, speckle_list_versions, speckle_get_version, speckle_get_object, speckle_get_object_children, speckle_graphql

See mcp-server/README.md for full documentation.

Technology Coverage

Technology	Versions	Notes
Speckle Server	2.x / 3.x	Primary target, both self-hosted and app.speckle.systems
SpecklePy	latest	Python SDK
Speckle.Sdk	latest	C# / .NET SDK
@speckle/viewer	latest	Web viewer component
Speckle Automate	latest	Serverless automation platform
Connectors	latest	Revit, Rhino, Grasshopper, Blender, AutoCAD, Civil3D, Tekla, Power BI

Contributing

Contributions are welcome. Each skill must meet the quality bar:

1. SKILL.md under 500 lines
2. YAML frontmatter with name (kebab-case, max 64 chars) and description (folded block scalar)
3. English-only content
4. Deterministic language (ALWAYS/NEVER, no "might", "consider", "often")
5. Verified against official Speckle documentation
6. Complete references/ directory (methods.md, examples.md, anti-patterns.md)

See WAY_OF_WORK.md for the full methodology and REQUIREMENTS.md for quality guarantees.

Documentation

Document	Purpose
INDEX.md	Complete skill catalog with trigger scenarios
ROADMAP.md	Project status (single source of truth)
REQUIREMENTS.md	Quality guarantees and per-area requirements
DECISIONS.md	Architectural decisions with rationale
SOURCES.md	Official reference URLs and verification rules
WAY_OF_WORK.md	7-phase development methodology
LESSONS.md	Lessons learned during development
CHANGELOG.md	Version history

Related Skill Packages

Package	Skills	Technology
Blender-Bonsai	73	Blender, Bonsai, IfcOpenShell, Sverchok
Frappe / ERPNext	53	Frappe Framework & ERPNext v14–v16
Tauri 2	27	Tauri 2 / Rust / TypeScript
Speckle	25	Speckle Data Platform (this package)
Nextcloud	24	Nextcloud
React	24	React
Three.js	24	Three.js, React Three Fiber, Drei
Docker	22	Docker Engine 24+ & Compose v2
Draw.io	22	Draw.io diagram generation
Vite	22	Vite
n8n	21	n8n workflow automation
QGIS	19	QGIS / PyQGIS spatial analysis
ThatOpen	18	ThatOpen Engine 3.3.x (web BIM)
pdf-lib	17	pdf-lib
Fluent-i18n	16	Project Fluent i18n
PDFjs	13	pdfjs-dist
SolidJS	6	SolidJS reactive framework

All packages at OpenAEC Foundation.

License

MIT

---

Companion Skills: Cross-Technology Integration

Cross-Tech AEC Integration Skills — 9 skills for technology boundaries

Skill	Boundary	What it adds
crosstech-impl-speckle-blender	Speckle ↔ Blender	Connector patterns, material mapping, Bonsai/IFC through Speckle
crosstech-impl-speckle-revit	Speckle ↔ Revit	Family type mapping, parameter sync, round-trip integrity
crosstech-impl-n8n-aec-pipeline	n8n ↔ Speckle	Webhook integration, change detection pipelines
crosstech-impl-docker-aec-stack	Docker ↔ Speckle	Speckle Server deployment (6-service docker-compose)

---

Built with the 7-phase research-first methodology by the OpenAEC Foundation.