К основному содержанию
скилл CX Codex

plingjs-integration — скилл для Claude Code

Скилл plingjs-integration для Claude Code помогает интегрировать, обновлять и настраивать библиотеку Pling в существующих приложениях на Vue, React или чистом JavaScript.

Apache-2.0 ★ 126 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add plingjs/pling --skill plingjs-integration -a claude-code
Открыть на GitHub

Что делает plingjs-integration

Скилл направляет агента при внедрении Pling как слоя декларируемых возможностей интерфейса. Он не заменяет существующие бизнес-сервисы и авторизацию бэкенда, а помогает разметить страницы: объявить ограниченные действия, записи, регионы и состояние только для чтения. При этом мутации выполняются через стандартные обработчики приложения.

Внутри заложены правила выбора адаптеров: @plingjs/vue для Vue 3, @plingjs/react для React 16.8+, @plingjs/react/legacy для старых версий React, @plingjs/vue2 для Vue 2.7 и @plingjs/vanilla для чистого DOM или ранних сборок. Скилл запрещает агенту добавлять универсальные селекторы click или вызовы eval, требуя точечной привязки к готовым элементам управления.

Ключи провайдеров моделей строго выносятся на сервер через @plingjs/server или собственный бэкенд, исключая утечку через браузерный бандл VITE_*. Доступ внешних MCP-агентов выносится отдельно через шлюз Surface.

Какие задачи решает

  • подключить библиотеку Pling к проектам на React, Vue или vanilla JS
  • разметить безопасные действия и контекст страницы для ассистента
  • настроить серверный шлюз модели без передачи API-ключей в браузер
  • организовать доступ внешних MCP-агентов через Surface

Примеры запросов агенту

  • Подключи Pling к нашему приложению на React 18
  • Объяви действия и состояние для формы заказов через Pling
  • Настрой серверный шлюз модели для Pling через наш backend

Как установить plingjs-integration

1Через Skills CLI (Vercel)

npx skills add plingjs/pling --skill plingjs-integration -a claude-code

2Вручную: положить файлы

~/.claude/skills/plingjs-integration/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/plingjs-integration/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о plingjs-integration

Как установить plingjs-integration в Claude Code?

Выполните команду npx skills add plingjs/pling --skill plingjs-integration -a claude-code в терминале.

Что делает plingjs-integration?

Помогает внедрить библиотеку Pling в существующий интерфейс, подбирает нужный адаптер фреймворка и декларирует доступные агенту операции.

Что нужно для работы plingjs-integration?

Требуется репозиторий приложения на Vue, React или vanilla JavaScript, а для вызовов моделей понадобится серверный шлюз вроде @plingjs/server.

Исходный текст

SKILL.md · Apache-2.0
---
name: plingjs-integration
description: Integrate, upgrade, or troubleshoot Pling in an existing Vue, React, Vue 2, or vanilla JavaScript application. Use when choosing an adapter, declaring page capabilities, connecting a model gateway, or exposing selected capabilities to an external Agent.
---

# Pling integration guide

Use this skill to help a developer add Pling to an application while keeping
the application's existing UI, business services, authorization, and data as
the source of truth. It is written for coding Agents that can read the target
repository; it does not assume a particular Agent product or MCP client.

Pling is a declared capability layer, not a browser automation engine or a
replacement for business APIs. The page declares bounded actions, records,
regions, and read-only state. The Agent proposes a declared operation; Pling
applies runtime policy and the application executes its existing handler.
Backend authorization remains authoritative.

## Working rules

1. Read the target app's `AGENTS.md`, package scripts, lockfile, auth model, and
   current working-tree state before editing.
2. Resolve the installed Pling version and framework version first. Alpha
   package APIs can change; never assume GitHub `main`, a tutorial, or a skill
   clone matches the package installed in the app. Use
   [version and source discovery](references/version-and-source-discovery.md).
3. Start with the smallest integration that satisfies the request. Preserve
   working UI and business logic; prefer declarations on existing controls or
   narrow function actions that call existing business services.
4. Keep read exposure allowlisted. Do not expose a whole Pinia/Vuex/Redux store,
   component instance, raw API response, secret, or unnecessary personal data.
   State helpers are read-only; mutations go through declared actions.
5. Never add generic `click(selector)`, `eval`, arbitrary script execution, or
   a tool that forwards unrestricted DOM events. Do not make an Agent its own
   approver.
6. Keep model-provider keys on the server. A `VITE_*` value is public after
   build. Do not put a provider key in browser code, local storage, a prompt, or
   a Surface session.
7. Treat model access and external-Agent access as separate integrations:
   model requests use a **model gateway**; remote MCP Agents use a **Surface
   gateway**. Read the relevant reference before wiring either one.
8. For a retrofit, establish and record the no-Pling baseline first. Work in
   the user's requested branch or worktree; do not overwrite a baseline or
   change unrelated failures silently.
9. Do not deploy, change credentials or authorization, run database migrations,
   or widen public/external access unless the user has authorized that specific
   action.

## Choose the integration path

| Existing application | Adapter | Notes |
| --- | --- | --- |
| Vue 3 | `@plingjs/vue` | Directives, composables, and shared assistant UI. |
| React 16.8+ | `@plingjs/react` | Hooks entry and shared assistant UI. |
| React 16.3–16.7 | `@plingjs/react/legacy` | Class/render-prop entry; do not use Hooks. |
| Vue 2.7 | `@plingjs/vue2` | Vue 2 plugin/directives over the DOM runtime. |
| Vue 2.6 or earlier | `@plingjs/vanilla` | Manual DOM declarations after mount; no Vue 2 adapter or automatic directive cleanup. |
| Plain JavaScript or jQuery | `@plingjs/vanilla` | DOM-first API; no framework dependency. |

This matrix describes the currently documented adapter shape. Verify the exact
peer dependencies and exports for the version the app will install. See
[framework adapters](references/framework-adapters.md).

## Integration sequence

1. **Understand the app.** Find routes, forms, dialogs, list/detail screens,
   business services, validation, roles, sensitive fields, and existing tests.
   Separate observed facts from assumptions.
2. **Prove the baseline.** Run the app's existing typecheck, tests, and build;
   smoke-test the main user workflow. Record pre-existing failures.
3. **Map capabilities.** For each user goal, identify the existing operation,
   required inputs and lookups, business preconditions, risk, confirmation,
   minimal returned data, and observable success evidence. Review the proposed
   surface with the user before adding sensitive or destructive operations.
4. **Mount one runtime.** Create one Pling instance at the app boundary and
   mount the adapter's assistant UI. Add only the styles documented for that
   adapter.
5. **Declare in small slices.** Add regions for meaningful page areas, records
   for rows/entities, and bounded read-only state for the current view. Declare
   existing controls with the adapter's action API. Use a function action when
   one business operation spans several UI steps or needs an application API.
6. **Connect model requests when needed.** Configure the browser with an
   application-owned endpoint and use `@plingjs/server` or an existing backend
   to keep provider credentials and access policy server-side. Read
   [model gateway setup](references/model-gateway.md).
7. **Add task guidance when useful.** Use task definitions/cards for named
   workflows with structured progress, references, or handoff. Do not create a
   task panel just to duplicate a simple chat turn. Follow the adapter's current
   task API reference rather than copying a demo's implementation wholesale.
8. **Add external Agent access only when requested.** Declare a narrow Surface,
   then add the required page session, authenticated BFF, gateway, and MCP
   client. Read [Surface and external Agents](references/surface-and-external-agents.md).
9. **Verify evidence.** Run focused tests, typecheck, and build. Test successful
   and rejected operations, ambiguous lookups, stale records, confirmation
   refusal, and the visible business result. Inspect the debug trace. Re-run the
   baseline workflow without Pling.
10. **Report the boundary.** List changed files, the exact Pling and framework
    versions, commands and outcomes, actions exposed, data sent to the model,
    unresolved assumptions, and rollback point.

## Find the exact API

Load only the reference needed for the current job:

- Framework setup and syntax: [framework adapters](references/framework-adapters.md)
- Provider credentials, browser config, and Node gateway: [model gateway](references/model-gateway.md)
- Third-party MCP Agent access: [Surface integration](references/surface-and-external-agents.md)
- Package versions, source checkout, tests, and repository map:
  [version and source discovery](references/version-and-source-discovery.md)

For full signatures and parameter tables, use the version-matched API reference:

- [Vue 3 API](https://plingjs.dev/reference/api/vue-3)
- [React API](https://plingjs.dev/reference/api/react)
- [Vanilla JavaScript API](https://plingjs.dev/reference/api/vanilla)
- [Vue 2.7 API](https://plingjs.dev/reference/api/vue-2)
- [Shared API](https://plingjs.dev/reference/api/shared)
- [Guided task API](https://plingjs.dev/reference/guided-task-api)
- [Release and compatibility notes](https://plingjs.dev/releases/)

For agent-oriented indexing, the docs site also publishes [llms.txt](https://plingjs.dev/llms.txt)
and [llms-full.txt](https://plingjs.dev/llms-full.txt). These help locate
material; they do not override the app's installed package types or matching
release docs.

If the installed package, its type declarations, its matching source tag, and
the documentation disagree, do not guess. Report the discrepancy and base the
change on the installed version's exported types and tested behavior.

© plingjs · Apache-2.0 · plingjs/pling

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
mapbox-web-integration-patterns mapbox Скилл mapbox-web-integration-patterns для Claude Code содержит официальные паттерны интеграции Mapbox GL JS в React, Vue, Svelte и Angular: жизненный цикл карты, токены и поиск. CX Codex +1 2 700установок ag-dev ag-grid Скилл ag-dev заставляет ИИ сверять версии AG Grid, AG Charts и AG Studio с документацией проекта, чтобы не писать код под устаревшие или выдуманные API. CX Codex +1 1 200установок tailwindcss-framework-integration JosiahSiegel Скилл tailwindcss-framework-integration помогает настроить Tailwind CSS в проектах на React, Vite, Next.js, Vue, Nuxt и SvelteKit. Пригодится при подключении плагинов сборщика, тёмной темы и слиянии классов. CX Codex +1 298установок atomic-design-integration TheBushidoCollective Скилл atomic-design-integration интегрирует методологию Atomic Design в React, Vue и Angular: структура папок, barrel exports, типизированные компоненты и хуки. CX Codex +1 114установок echarts sentimony Скилл echarts для Claude Code настраивает, стилизует и чинит графики Apache ECharts в JavaScript, React и Vue. Он следит за жизненным циклом компонентов, адаптивным ресайзом и tree-shaking. CX Codex +1 4 600установок lingui-best-practices lingui Скилл lingui-best-practices помогает внедрять Lingui для локализации интерфейсов и каталогов переводов. Пригодится при добавлении i18n в приложения на React, Vue или JavaScript. CX Codex +1 811установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой