freemcplab / 目录 / 演练场 / prismatic-skills

● 社区 prismatic-io ⚡ 即开即用

prismatic-skills

Name: prismatic-skills (Claude Skill)
Author: prismatic-io

作者 prismatic-io · prismatic-io/prismatic-skills

First-party Prismatic.io skills for building code-native integrations and custom connectors — spin up connectors without clicking through the UI.

Prismatic publishes these skills for their integration platform. They teach Claude Code how to build code-native Prismatic integrations: scaffolding connectors, writing action handlers, testing locally with their SDK, and deploying. Official source, focused scope.

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

First-party — published by Prismatic.io
Covers code-native integrations (TypeScript)
Connector scaffolding and action patterns
Local dev loop with Prismatic SDK
Deploy to Prismatic platform

实时演示

实际使用效果

prismatic-skill.replay ▶ 就绪

0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： prismatic-skills

Build a custom Prismatic connector for an internal API

👤 Integration engineers on teams using Prismatic ⏱ ~90 min advanced

何时使用： You have an internal API that your Prismatic flows need to talk to.

步骤

Scaffold the connector

Use prismatic-skills. Scaffold a connector for our Orders API — base URL, bearer auth, actions for list, get, create.✓ 已复制

→ Connector directory with TS entry points, manifest, test files
Implement actions

Fill in the listOrders action with pagination and error handling.✓ 已复制

→ TS implementation with types and Prismatic input/output conventions
Test locally

Run the test harness with a mock response.✓ 已复制

→ prism tests output; green

结果： A deployable connector with actions your flows can use.

注意事项

Missing input validation — Prismatic validates at the platform boundary; still use Zod or similar for runtime safety

搭配使用： filesystem

Add a new action to an existing Prismatic connector

👤 Maintainers of deployed connectors ⏱ ~30 min intermediate

何时使用： Business needs a new action (e.g., refund flow) on an existing integration.

步骤

Identify the pattern

Use prismatic-skills. Look at the existing actions/ and mimic the pattern for a new 'refundOrder' action.✓ 已复制

→ Action file consistent with existing style
Publish

Bump the connector version and deploy.✓ 已复制

→ prism integrations:publish succeeded

结果： Connector updated without breaking existing flows.

注意事项

Breaking input schema without version bump — Version the connector; old flows pin to old version until migrated

组合

与其他 MCP 搭配，撬动十倍杠杆

prismatic-skill + filesystem

Manage a multi-connector monorepo

Add connectors/widgets-api/ following the same pattern as connectors/users-api/.✓ 已复制

prismatic-skill + github

Review connector PRs with skill context

Review this PR against Prismatic connector conventions.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
scaffold_connector	name, auth type, actions	New connector	0
write_action	action spec	Per-action implementation	0
run_tests	connector path	Before publish	local
publish_connector	connector path	Deploy	Prismatic deploy

成本与限制

运行它的成本

API 配额: None in skill
每次调用 Token 数: Moderate
费用: Prismatic plan applies; skill is free
提示: Test locally with the SDK before pushing to reduce deploy churn.

安全

权限、密钥、影响范围

凭据存储： Prismatic credentials via prism CLI (not stored in skill)

数据出站： Prismatic platform + whatever APIs your connectors talk to

Connector code runs on the Prismatic platform — don't embed secrets; use Prismatic's credential store.

故障排查

常见错误与修复

prism login fails

Token scope or expiry; re-login via browser flow

验证： prism me

Connector publishes but flows can't see new action

Customers may need to upgrade connector version in their flow settings

Input schema rejected

Prismatic enforces specific input shapes; consult their docs or the skill's action templates

替代方案