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:

Setup - Verify Prism CLI and authentication
Requirements - Interactive questionnaire (component type, API details)
API Research - For connectors, research the external API
Scaffold - Generate component structure via Prism CLI
Code Generation - Implement actions, triggers, connections
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:

Setup - Verify Prism CLI and authentication
Requirements - Interactive questionnaire (systems, triggers, data flow)
Credential Collection - Gather OAuth/API credentials if needed
Scaffold - Generate project structure with component manifests
Code Generation - Create TypeScript files (flows, config pages, etc.)
Build, Deploy & Test - Compile, deploy, and test flows
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.

Workflow scripts (root level):

prerequisites.ts - Verify Prism CLI, authentication, and create a session directory
gather-requirements.ts - DAG-based interactive questionnaire that walks through requirements in dependency order, skipping irrelevant questions automatically
write-answer.ts - Write an answer to the requirements file for programmatic use

Component scripts (scripts/components/):

scaffold-component.ts - Create component project structure via Prism CLI
build-component.ts - Compile TypeScript with webpack
publish-component.ts - Deploy component to Prismatic
validate-component.ts - Validate the published component

Integration scripts (scripts/integrations/):

scaffold-project.ts - Create CNI project with component manifests
find-components.ts - Find available Prismatic components
extract-connections.ts - Extract connection options from components
get-credential-prompts.ts - Get credential fields for a connection
build-integration.ts - Compile TypeScript
deploy-integration.ts - Deploy to Prismatic
test-integration.ts - Test flow execution
install-dependencies.ts - Install npm packages
validate-typescript.ts - TypeScript validation
troubleshoot.ts - Quick diagnostics
package-for-download.ts - Create downloadable package

Shared utilities (scripts/shared/):

graphql.ts - GraphQL query execution via Prism CLI
prism-retry.ts - CLI command retry logic
project-directory.ts - Session directory management
search-connections.ts - Find integration-agnostic connections
check-prism-access.ts - Verify Prism CLI authentication
timing.ts - Performance timing utilities

Repository Structure

prismatic-skills/
├── .claude-plugin/
│   ├── plugin.json                  # Plugin manifest
│   └── marketplace.json             # Marketplace catalog
├── .mcp.json                        # Bundled Prism MCP server config
├── commands/
│   ├── build-component.md           # /prismatic-skills:build-component
│   ├── build-integration.md         # /prismatic-skills:build-integration
│   └── orby.md                      # /prismatic-skills:orby
├── agents/
│   ├── component-builder.md
│   ├── cni-builder.md
│   ├── external-api-researcher.md
│   └── orby.md
├── skills/
│   ├── component-patterns/          # Component reference docs & examples
│   ├── integration-patterns/        # CNI reference docs & pattern library
│   ├── prismatic-api/               # GraphQL & API reference
│   └── prismatic-docs/              # Documentation search reference
├── scripts/
│   ├── prerequisites.ts             # Environment setup
│   ├── gather-requirements.ts       # DAG-based questionnaire
│   ├── write-answer.ts              # Programmatic answer writing
│   ├── components/                  # Component lifecycle scripts
│   ├── integrations/                # Integration lifecycle scripts
│   ├── shared/                      # Shared utilities
│   └── questions/
│       ├── component.json           # Component questionnaire DAG
│       └── integration.json         # Integration questionnaire DAG
└── README.md

License

MIT