prismatic-skills

Prismatic Skills

Claude Code plugin for building and managing Prismatic integrations through conversation. Build custom components, generate Code Native Integrations, explore your Prismatic environment, and operate the platform — all from your editor.

Prerequisites

• Prism CLI: Install via npm install -g @prismatic-io/prism (also provides the bundled MCP server)
• Prismatic Account: Active account with integration/component permissions
• Node.js 18+: Required for workflow scripts (run via tsx)
• Claude Code: CLI or extension with plugin support

Installation

Add the marketplace and install the plugin in Claude Code:

/plugin marketplace add prismatic-io/prismatic-skills
/plugin install prismatic-skills@prismatic-skills

Development / Testing

For local development, load the plugin directly:

claude --plugin-dir /path/to/prismatic-skills

Available Commands

/prismatic-skills:build-component

Build and deploy a Prismatic custom component.

/prismatic-skills:build-component Canny API connector

Workflow:

1. Setup - Verify Prism CLI and authentication
2. Requirements - Interactive questionnaire (component type, API details)
3. API Research - For connectors, research the external API
4. Scaffold - Generate component structure via Prism CLI
5. Code Generation - Implement actions, triggers, connections
6. Build & Publish - Compile and deploy to Prismatic

/prismatic-skills:build-integration

Build and deploy a Prismatic Code Native Integration (CNI).

/prismatic-skills:build-integration Salesforce to Slack sync

Workflow:

1. Setup - Verify Prism CLI and authentication
2. Requirements - Interactive questionnaire (systems, triggers, data flow)
3. Credential Collection - Gather OAuth/API credentials if needed
4. Scaffold - Generate project structure with component manifests
5. Code Generation - Create TypeScript files (flows, config pages, etc.)
6. Build, Deploy & Test - Compile, deploy, and test flows
7. Iterate - Fix issues, rebuild, redeploy

/prismatic-skills:orby

Ask Orby, the Prismatic platform guide, about your environment or have it perform platform operations.

/prismatic-skills:orby What integrations do I have?
/prismatic-skills:orby Deploy the Slack integration to Acme Corp
/prismatic-skills:orby How do I query execution logs in GraphQL?
/prismatic-skills:orby Show me the last 10 failed executions

Capabilities:

• Environment exploration - List components, integrations, instances, customers, and executions
• Platform operations - Deploy integrations, manage instances, create customers
• GraphQL query construction - Build and execute queries against the Prismatic API
• Documentation search - Search and retrieve content from prismatic.io/docs
• Workflow orchestration - Multi-step operations like end-to-end deployment
• Troubleshooting - Investigate failed executions, check logs, diagnose issues

Agents

Agent	Description
component-builder	Builds custom components from requirements to deployment. Uses a DAG-driven questionnaire, optional API research, and per-phase scripts for scaffolding, building, and publishing.
cni-builder	Builds Code Native Integrations from requirements to deployment. Manages component manifests, OAuth configuration, TypeScript generation, deploy, and test cycles.
external-api-researcher	Researches external APIs by fetching and analyzing documentation. Extracts authentication methods, endpoints, data models, and webhook capabilities into a structured JSON spec. Only spawned when the requirements DAG determines research is needed.
orby	Interactive Prismatic platform guide. Explores your environment, executes platform operations, constructs GraphQL queries, searches documentation, and orchestrates multi-step workflows.

Skills

The plugin includes four knowledge bases that agents draw on:

Skill	Purpose
component-patterns	Reference docs, code generation patterns, and complete examples (utility, API key connector, OAuth2 connector) for building custom components
integration-patterns	Reference docs, CNI pattern library (webhooks, state persistence, error handling, OAuth, multi-flow, etc.), and code generation guide for Code Native Integrations
prismatic-api	GraphQL query reference, API access hierarchy (MCP tools / Prism CLI), query patterns for customers, instances, executions, logs, components, and integrations
prismatic-docs	Documentation search strategies for prismatic.io/docs and example code navigation from the Prismatic examples repo

Scripts

Builder agents are driven by TypeScript scripts in scripts/ that handle every phase of the workflow. Agents call these scripts via npx tsx rather than performing platform operations directly.