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.

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