{
  "markdown": "# Prismatic Skills\n\nClaude Code plugin for building and managing [Prismatic](https://www.prismatic.io) integrations through conversation. Build custom components, generate Code Native Integrations, migrate integrations from other platforms, embed Prismatic in your app, explore your environment, and operate the platform — all from your editor.\n\n## Prerequisites\n\n- **Prism CLI**: Install via `npm install -g @prismatic-io/prism` (the MCP server is provisioned automatically from the plugin config)\n- **Prismatic Account**: Active account with integration/component permissions\n- **Node.js 22.18+**: Required for native TypeScript workflow scripts\n- **Claude Code**: CLI or extension with plugin support\n\n## Installation\n\nAdd the marketplace and install the plugin in Claude Code:\n\n```bash\n/plugin marketplace add prismatic-io/prismatic-skills\n/plugin install prismatic-skills@prismatic-skills\n/reload-plugins\n```\n\n### Development / Testing\n\nFor local development, load the plugin directly:\n\n```bash\nexport PRISMATIC_MARKETPLACE_CHECKOUT=/path/to/prismatic-skills\nclaude --plugin-dir ${PRISMATIC_MARKETPLACE_CHECKOUT}/plugin\n```\n\n## Available Commands\n\n### `/prismatic-skills:build-component`\n\nBuild and deploy a Prismatic custom component.\n\n```\n/prismatic-skills:build-component Canny API connector\n```\n\nWorkflow:\n\n1. **Setup** - Verify Prism CLI and authentication\n2. **Requirements** - Interactive questionnaire (component type, API details)\n3. **API Research** - For connectors, research the external API\n4. **Scaffold** - Generate component structure via Prism CLI\n5. **Code Generation** - Implement actions, triggers, connections\n6. **Build & Publish** - Compile and deploy to Prismatic\n\n### `/prismatic-skills:build-integration`\n\nBuild and deploy a Prismatic Code Native Integration (CNI).\n\n```\n/prismatic-skills:build-integration Salesforce to Slack sync\n```\n\nWorkflow:\n\n1. **Setup** - Verify Prism CLI and authentication\n2. **Requirements** - Interactive questionnaire (systems, triggers, data flow)\n3. **Credential Collection** - Gather OAuth/API credentials if needed\n4. **Scaffold** - Generate project structure with component manifests\n5. **Code Generation** - Create TypeScript files (flows, config pages, etc.)\n6. **Build, Deploy & Test** - Compile, deploy, and test flows\n7. **Iterate** - Fix issues, rebuild, redeploy\n\n### `/prismatic-skills:modify-integration`\n\nModify an existing Prismatic Code Native Integration.\n\n```\n/prismatic-skills:modify-integration Add error retry logic to the Salesforce sync\n```\n\nWorkflow:\n\n1. **Setup** - Create session and extract current integration state\n2. **Requirements** - Gather modification details via questionnaire\n3. **Code Changes** - Update TypeScript files following existing patterns\n4. **Build, Deploy & Test** - Compile, deploy, and verify changes\n\n### `/prismatic-skills:migrate-integration`\n\nMigrate an integration from another platform (like Boomi or Cyclr) to a Prismatic Code Native Integration.\n\n```\n/prismatic-skills:migrate-integration ./exports/my-boomi-process\n```\n\nWorkflow:\n\n1. **Detect Platform** - Identify the source platform from export files\n2. **Parse Export** - Extract processes, connectors, and data mappings\n3. **Generate Schema** - Produce a standardized integration schema\n4. **Map to Requirements** - Convert schema to Prismatic build requirements\n5. **Build** - Hand off to the standard CNI build pipeline\n\nSupported platforms: Boomi, Cyclr\n\n### `/prismatic-skills:embedded`\n\nSet up Prismatic embedding — marketplace, workflow builder, or custom UI — in your web application.\n\n```\n/prismatic-skills:embedded Add the integration marketplace to our Next.js app\n/prismatic-skills:embedded Set up JWT signing for embedded Prismatic\n```\n\nWorkflow:\n\n1. **Stack Discovery** - Identify your framework and backend language\n2. **Signing Keys** - Configure JWT signing key setup\n3. **Backend** - Generate JWT token endpoint\n4. **Frontend** - Integrate the embedded SDK with your framework\n\n### `/prismatic-skills:orby`\n\nAsk Orby, the Prismatic platform guide, about your environment or have it perform platform operations.\n\n```\n/prismatic-skills:orby What integrations do I have?\n/prismatic-skills:orby Deploy the Slack integration to Acme Corp\n/prismatic-skills:orby How do I query execution logs in GraphQL?\n/prismatic-skills:orby Show me the last 10 failed executions\n```\n\nCapabilities:\n\n- **Environment exploration** - List components, integrations, instances, customers, and executions\n- **Platform operations** - Deploy integrations, manage instances, create customers\n- **GraphQL query construction** - Build and execute queries against the Prismatic API\n- **Documentation search** - Search and retrieve content from prismatic.io/docs\n- **Workflow orchestration** - Multi-step operations like end-to-end deployment\n- **Troubleshooting** - Investigate failed executions, check logs, diagnose issues\n\n### `/prismatic-skills:version`\n\nCheck which plugin version is loaded and whether the session is stale.\n\n## Agents\n\n| Agent                     | Description                                                                                                                                                                                                             |\n| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `component-builder`       | Builds custom components from requirements to deployment. Handles scaffolding, code generation, building, and publishing.                                                                                               |\n| `cni-builder`             | Builds Code Native Integrations from requirements to deployment. Manages component manifests, OAuth configuration, TypeScript generation, deploy, and test cycles. Also handles modifications to existing integrations. |\n| `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.                                        |\n| `embedded-advisor`        | Guides developers through embedding Prismatic's marketplace and workflow builder in their web application. Handles signing key setup, JWT backend generation, frontend SDK integration, theming, and i18n.              |\n| `migration-analyzer`      | Parses integration exports from other platforms (Boomi, Cyclr) and produces a standardized integration schema for migration to Prismatic.                                                                               |\n| `migration-reviewer`      | Reviews and validates migration analysis output before handing off to the CNI build pipeline.                                                                                                                           |\n| `orby`                    | Interactive Prismatic platform guide. Explores your environment, executes platform operations, constructs GraphQL queries, searches documentation, and orchestrates multi-step workflows.                               |\n\n## Skills\n\nThe plugin includes eight knowledge bases that agents draw on:\n\n| Skill                  | Purpose                                                                                                                                                               |\n| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `component-patterns`   | Reference docs, code generation patterns, and complete examples (utility, API key connector, OAuth2 connector) for building custom components                         |\n| `integration-patterns` | Reference docs, CNI pattern library (webhooks, state persistence, error handling, OAuth, multi-flow, etc.), and code generation guide for Code Native Integrations    |\n| `prismatic-api`        | GraphQL query reference, API access hierarchy (MCP tools / Prism CLI), query patterns for customers, instances, executions, logs, components, and integrations        |\n| `prismatic-docs`       | Documentation search strategies for prismatic.io/docs and example code navigation from the Prismatic examples repo                                                    |\n| `embedded`             | Reference documentation for embedding Prismatic's integration marketplace and workflow builder in a web application, including JWT auth, SDK setup, theming, and i18n |\n| `migration-framework`  | Standardized integration schema, schema-to-requirements mapping, and migration code generation guide                                                                  |\n| `boomi-migration`      | Boomi concept mapping and export parsing reference for migrating Boomi processes to Prismatic                                                                         |\n| `cyclr-migration`      | Cyclr concept mapping and export parsing reference for migrating Cyclr workflows to Prismatic                                                                         |\n\n## Scripts\n\nBuilder agents are driven by TypeScript scripts in `scripts/` that handle every phase of the workflow. Agents call these scripts with Node.js 22.18+'s built-in TypeScript support rather than performing platform operations directly.\n\n**Workflow scripts** (root level):\n\n- `prerequisites.ts` - Verify Prism CLI, authentication, and create a session directory\n- `validate-requirements.ts` - Validate that all required questions have been answered\n- `write-answer.ts` - Write an answer to the requirements file for programmatic use\n- `run.ts` - Dispatcher for running scripts by name\n\n**Component scripts** (`scripts/components/`):\n\n- `scaffold-component.ts` - Create component project structure via Prism CLI\n- `build-component.ts` - Compile TypeScript with webpack\n- `publish-component.ts` - Deploy component to Prismatic\n- `validate-component.ts` - Validate the published component\n- `create-organization-connection.ts` - Create a reusable connection in the Prismatic org\n\n**Integration scripts** (`scripts/integrations/`):\n\n- `scaffold-project.ts` - Create CNI project with component manifests\n- `find-components.ts` - Find available Prismatic components\n- `extract-connections.ts` - Extract connection options from components\n- `get-credentials.ts` - Get credential fields for a connection\n- `build-integration.ts` - Compile TypeScript\n- `deploy-integration.ts` - Deploy to Prismatic\n- `test-integration.ts` - Test flow execution\n- `install-dependencies.ts` - Install npm packages\n- `validate-typescript.ts` - TypeScript validation\n- `troubleshoot.ts` - Quick diagnostics\n- `package-for-download.ts` - Create downloadable package\n- `extract-state.ts` - Read an existing integration's configuration\n- `locate-project.ts` - Find where an integration project lives on disk\n- `record-choices.ts` - Record design decisions for a session\n- `update-tasks.ts` - Track answered questions and next steps\n- `verify-code.ts` - Check that code matches requirements\n- `search-connections.ts` - Find integration-agnostic connections\n\n**Migration scripts** (`scripts/migration/`):\n\n- `detect-platform.ts` - Identify the source platform from export files\n- `parse-export.ts` - Parse integration exports (delegates to platform-specific parsers)\n- `parse-boomi-export.ts` - Parse Boomi process exports\n- `parse-cyclr-export.ts` - Parse Cyclr workflow exports\n- `generate-mermaid-diagrams.ts` - Generate flow diagrams from parsed exports\n- `schema-to-answers.ts` - Convert standardized schema to Prismatic build requirements\n\n**Shared utilities** (`scripts/shared/`):\n\n- `graphql.ts` - GraphQL query execution via Prism CLI\n- `prism-retry.ts` - CLI command retry logic\n- `project-directory.ts` - Session directory management\n- `check-prism-access.ts` - Verify Prism CLI authentication\n- `timing.ts` - Performance timing utilities\n- `code-plan.ts` - Generate code-gen plans from requirements\n- `diagnose-build.ts` - Diagnose build failures and suggest fixes\n- `install-manifest.ts` - Install a component manifest into a CNI project\n- `load-spec.ts` - Load YAML question specs\n- `parse-yaml.ts` - YAML parsing utilities\n- `validate-phase.ts` - Verify project readiness for each workflow phase\n\n## Hooks\n\nThe plugin registers Claude Code hooks for enforcing workflow rules:\n\n- `pretooluse-dispatch.mjs` - Dispatches pre-tool-use checks based on the tool manifest\n- `check-destructive.mjs` - Pauses before destructive operations for agent confirmation\n- `session-start-discovery.mjs` - Captures plugin version at session start\n\n## Templates\n\nCode generation templates in `templates/` define the required file structure for generated components and integrations. Each `.template` file contains structural boilerplate with typed slots (`{{SLOT_NAME}}`) that the agent fills from requirements.\n\n- **Component templates**: `index.ts`, `actions.ts`, `connections.ts`, `client.ts`, `triggers.ts`, `inputs.ts`, `rawRequest.ts`\n- **Integration templates**: `index.ts`, `componentRegistry.ts`, `configPages.ts`, `flows.ts`, `flows-index.ts`\n\n## Repository Structure\n\n```\nprismatic-skills/\n├── .claude-plugin/\n│   ├── plugin.json                  # Plugin manifest\n│   └── marketplace.json             # Marketplace catalog\n├── .mcp.json                        # Bundled Prism MCP server config\n├── CLAUDE.md                        # Agent orchestration instructions\n├── commands/\n│   ├── build-component.md           # /prismatic-skills:build-component\n│   ├── build-integration.md         # /prismatic-skills:build-integration\n│   ├── modify-integration.md        # /prismatic-skills:modify-integration\n│   ├── migrate-integration.md       # /prismatic-skills:migrate-integration\n│   ├── embedded.md                  # /prismatic-skills:embedded\n│   ├── orby.md                      # /prismatic-skills:orby\n│   └── version.md                   # /prismatic-skills:version\n├── agents/\n│   ├── component-builder.md\n│   ├── cni-builder.md\n│   ├── external-api-researcher.md\n│   ├── embedded-advisor.md\n│   ├── migration-analyzer.md\n│   ├── migration-reviewer.md\n│   └── orby.md\n├── skills/\n│   ├── component-patterns/          # Component reference docs & examples\n│   ├── integration-patterns/        # CNI reference docs & pattern library\n│   ├── prismatic-api/               # GraphQL & API reference\n│   ├── prismatic-docs/              # Documentation search reference\n│   ├── embedded-patterns/           # Embedded marketplace & workflow builder\n│   ├── migration-framework/         # Standardized migration schema & mapping\n│   ├── boomi-migration/             # Boomi-specific parsing & concept mapping\n│   └── cyclr-migration/             # Cyclr-specific parsing & concept mapping\n├── hooks/\n│   ├── hooks.json                   # Hook registration\n│   ├── pretooluse-dispatch.mjs      # Pre-tool-use check dispatcher\n│   ├── check-destructive.mjs        # Destructive operation guard\n│   ├── session-start-discovery.mjs  # Plugin version capture\n│   └── tool-manifest.json           # Tool dispatch rules\n├── templates/\n│   ├── component/                   # Component code generation templates\n│   └── integration/                 # Integration code generation templates\n├── scripts/\n│   ├── prerequisites.ts             # Environment setup\n│   ├── validate-requirements.ts     # Requirements validation\n│   ├── write-answer.ts              # Programmatic answer writing\n│   ├── run.ts                       # Script dispatcher\n│   ├── components/                  # Component lifecycle scripts\n│   ├── integrations/                # Integration lifecycle scripts\n│   ├── migration/                   # Platform migration scripts\n│   ├── shared/                      # Shared utilities\n│   └── questions/\n│       ├── component.yaml           # Component questionnaire spec\n│       ├── integration.yaml         # Integration questionnaire spec\n│       ├── modify-integration.yaml  # Modification questionnaire spec\n│       ├── component/               # Component question groups\n│       └── integration/             # Integration question groups\n└── README.md\n```\n\n## License\n\nMIT\n",
  "bytes": 16334,
  "sha": "2e52f0dab3bc31d6771cb0cfb0be87e011f650434ad198fb378bdab8abd88780",
  "repo_slug": "prismatic-io/prismatic-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_prismatic_io_prismatic_skills_prismatic__39bb92e3/readme"
}