{"owner":"plasmicapp","repo":"plasmic","hasSkills":true,"totalSkillsCount":149,"totalTokensCount":47942,"categories":["anthropic-skill","claude-rule","plugin-manifest","root-instruction"],"hasMcp":false,"mcpConfig":null,"found":["packages/auth-api/package.json","CLAUDE.md","packages/auth-api/tsconfig.json","packages/auth-react/README.md","packages/auth-api/README.md","ai/skills/plasmic-designer/SKILL.md","packages/auth-react/package.json","packages/cli/package.json","packages/auth-react/tsconfig.json","packages/cli/tsconfig-transform.json","AGENTS.md","packages/cli/README.md","packages/cli/tsconfig.json","packages/create-plasmic-app/README.md","packages/create-plasmic-app/package.json","packages/create-plasmic-app/tsconfig.json","packages/data-sources-context/README.md","packages/data-sources-context/package.json","packages/data-sources-context/tsconfig.json","packages/data-sources/README.md","packages/data-sources/package.json","packages/data-sources/tsconfig.json","packages/host/README.md","packages/host/package.json","packages/host/tsconfig.json","packages/loader-angular/README.md","packages/loader-angular/package.json","packages/loader-core/README.md","packages/loader-core/package.json","packages/loader-core/tsconfig.json","packages/loader-edge/README.md","packages/loader-edge/package.json","packages/loader-edge/tsconfig.json","packages/loader-fetcher/README.md","packages/loader-fetcher/package.json","packages/loader-fetcher/tsconfig.json","packages/loader-gatsby/README.md","packages/loader-gatsby/package.json","packages/loader-gatsby/tsconfig.json","packages/loader-nextjs/README.md","packages/loader-nextjs/package.json","packages/loader-nextjs/tsconfig.json","packages/loader-react/README.md","packages/loader-react/package.json","packages/loader-react/tsconfig.json","packages/loader-splits/README.md","packages/loader-splits/package.json","packages/loader-splits/tsconfig.json","packages/loader-svelte/README.md","packages/loader-svelte/package.json","packages/loader-vue/README.md","packages/loader-vue/package.json","packages/nextjs-app-router/README.codegen.md","packages/nextjs-app-router/README.md","packages/nextjs-app-router/package.json","packages/nextjs-app-router/tsconfig.json","packages/plasmic/package.json","packages/prepass/package.json","packages/prepass/tsconfig.json","packages/query/README.md","packages/query/package.json","packages/query/tsconfig.json","packages/react-web-runtime/package.json","packages/react-web-runtime/tsconfig.json","packages/react-web/.babelrc.json","packages/react-web/README.md","packages/react-web/package.json","packages/react-web/tsconfig.json","packages/watcher/README.md","packages/watcher/package.json","packages/watcher/tsconfig.json","ai/skills/plasmic-designer/README.md","packages/auth-api/api/index.api.md","packages/auth-react/api/index.api.md","packages/cli/testData/fixImports_plasmic.json","packages/data-sources-context/api/index.api.md","packages/data-sources/api/index.api.md","packages/host/registerComponent/package.json","packages/host/registerFunction/package.json","packages/host/registerGlobalContext/package.json","packages/host/registerToken/package.json","packages/host/registerTrait/package.json","packages/loader-core/api/index.api.md","packages/loader-edge/api/index.api.md","packages/loader-fetcher/api/index.api.md","packages/loader-gatsby/api/gatsby-node.api.md","packages/loader-gatsby/api/gatsby-ssr.api.md","packages/loader-gatsby/api/index.api.md","packages/loader-nextjs/api/edge.api.md","packages/loader-nextjs/api/index.api.md","packages/loader-nextjs/api/react-server.api.md","packages/loader-react/api/index.api.md","packages/loader-react/api/react-server.api.md","packages/loader-splits/api/index.api.md","packages/nextjs-app-router/api/index.api.md","packages/nextjs-app-router/api/react-server.api.md","packages/query/api/index.api.md","packages/react-web-runtime/jsx-dev-runtime/package.json","packages/react-web-runtime/jsx-runtime/package.json","packages/react-web/skinny/package.json","packages/watcher/api/index.api.md","plasmicpkgs/commerce-providers/commercetools/README.md","ai/skills/plasmic-designer/references/design-guidelines.md","ai/skills/plasmic-designer/references/html-constraints.md","ai/skills/plasmic-designer/references/query-migration.md","packages/create-plasmic-app/cpa-out/gatsby-codegen-js/package.json","packages/create-plasmic-app/cpa-out/gatsby-codegen-js/plasmic.json","packages/create-plasmic-app/cpa-out/gatsby-codegen-ts/package.json","packages/create-plasmic-app/cpa-out/gatsby-codegen-ts/plasmic.json","packages/create-plasmic-app/cpa-out/gatsby-codegen-ts/tsconfig.json","packages/create-plasmic-app/cpa-out/gatsby-loader-js/package.json","packages/create-plasmic-app/cpa-out/gatsby-loader-ts/package.json","packages/create-plasmic-app/cpa-out/gatsby-loader-ts/tsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-app-codegen-js/jsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-app-codegen-js/package.json","packages/create-plasmic-app/cpa-out/nextjs-app-codegen-js/plasmic.json","packages/create-plasmic-app/cpa-out/nextjs-app-codegen-ts/package.json","packages/create-plasmic-app/cpa-out/nextjs-app-codegen-ts/plasmic.json","packages/create-plasmic-app/cpa-out/nextjs-app-codegen-ts/tsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-app-loader-js/jsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-app-loader-js/package.json","packages/create-plasmic-app/cpa-out/nextjs-app-loader-ts/package.json","packages/create-plasmic-app/cpa-out/nextjs-app-loader-ts/tsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-pages-codegen-js/jsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-pages-codegen-js/package.json","packages/create-plasmic-app/cpa-out/nextjs-pages-codegen-js/plasmic.json","packages/create-plasmic-app/cpa-out/nextjs-pages-codegen-ts/package.json","packages/create-plasmic-app/cpa-out/nextjs-pages-codegen-ts/plasmic.json","packages/create-plasmic-app/cpa-out/nextjs-pages-codegen-ts/tsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-pages-loader-js/jsconfig.json","packages/create-plasmic-app/cpa-out/nextjs-pages-loader-js/package.json","packages/create-plasmic-app/cpa-out/nextjs-pages-loader-ts/package.json","packages/create-plasmic-app/cpa-out/nextjs-pages-loader-ts/tsconfig.json","packages/create-plasmic-app/cpa-out/react-codegen-js/package.json","packages/create-plasmic-app/cpa-out/react-codegen-js/plasmic.json","packages/create-plasmic-app/cpa-out/react-codegen-ts/package.json","packages/create-plasmic-app/cpa-out/react-codegen-ts/plasmic.json","packages/create-plasmic-app/cpa-out/react-codegen-ts/tsconfig.json","packages/create-plasmic-app/cpa-out/tanstack-codegen-ts/package.json","packages/create-plasmic-app/cpa-out/tanstack-codegen-ts/plasmic.json","packages/create-plasmic-app/cpa-out/tanstack-codegen-ts/tsconfig.json","packages/host/src/__tests__/tsconfig.json","packages/react-web/lib/auth/package.json","packages/react-web/lib/data-sources/package.json","packages/react-web/lib/host/package.json","packages/react-web/lib/query/package.json","platform/canvas-packages/internal_pkgs/react-slick/README.md","platform/wab/tools/docker-dev/secrets.json","platform/wab/tools/react-devtools-chrome-ext/manifest.json"],"skills":{"packages/auth-api/package.json":"{\n \"version\": \"0.0.20\",\n \"description\": \"Framework-agnostic client for Plasmic Auth login, logout, and user session flows.\",\n \"homepage\": \"https://www.plasmic.app\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/plasmicapp/plasmic.git\",\n \"directory\": \"packages/auth-api\"\n },\n \"license\": \"MIT\",\n \"types\": \"./dist/index.d.ts\",\n \"main\": \"./dist/index.js\",\n \"module\": \"./dist/index.esm.js\",\n \"exports\": {\n \".\": {\n \"types\": \"./dist/index.d.ts\",\n \"import\": \"./dist/index.esm.js\",\n \"require\": \"./dist/index.js\"\n }\n },\n \"files\": [\n \"dist\"\n ],\n \"engines\": {\n \"node\": \">=10\"\n },\n \"scripts\": {\n \"build\": \"pnpm build:types && pnpm build:index\",\n \"build:types\": \"tsc\",\n \"build:index\": \"node ../../build.mjs ./src/index.ts\",\n \"test\": \"TEST_CWD=`pwd` pnpm -w test --passWithNoTests\",\n \"lint\": \"eslint\",\n \"prepublishOnly\": \"npm run build\",\n \"postpublish\": \"bash ../../scripts/publish-api-doc-model.sh\",\n \"size\": \"size-limit\",\n \"analyze\": \"size-limit --why\"\n },\n \"name\": \"@plasmicapp/auth-api\",\n \"author\": \"Chung Wu\",\n \"size-limit\": [\n {\n \"path\": \"dist/index.js\",\n \"limit\": \"10 KB\"\n }\n ],\n \"dependencies\": {\n \"@plasmicapp/isomorphic-unfetch\": \"1.0.3\"\n },\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"gitHead\": \"fa53f7d79f0e26d8b061102fda0c06788da6f8a7\"\n}\n","CLAUDE.md":"# CLAUDE.md\n\n## Sandbox\n\nYou might be in a sandbox. Check out [safehouse.sb](docs/internal/ai-sandbox/macos/safehouse.sb).\n\n## Key tools of root directory\n\nThis is root directory of the monorepo. Most development will be done in individual packages, but this directory is responsible for some centrally managed concerns:\n\n- package.json - common devDependencies where we want to use the same version everywhere\n- build.mjs - common build script for `packages/`\n- .eslintrc.js - shared eslint lint configuration\n- vitest.root.ts - shared Vitest unit test configuration for `packages/` and `plasmicpkgs/`\n- knip.ts - checks for unused dependencies, run with `knip:deps`\n\n## Key directories\n\nPlasmic is an open-source visual web builder. This monorepo contains:\n\n- **Platform** (`platform/`) - Apps that make up the Plasmic platform, such as the wab, img-optimizer, etc\n- **SDK packages** (`packages/`) - npm packages for integrating with Plasmic\n- **Plasmic packages** (`plasmicpkgs/`) - npm packages that provide code components on Plasmic\n- **Examples** (`examples/`) - Miscellaneous reference implementations\n\n## Tech Stack\n\n- Infra: Docker, k8s, Terraform\n- JavaScript tooling: asdf and pnpm\n- Languages: Node.js, TypeScript\n- Libraries: React, MobX, TypeORM, Vitest, Playwright, Storybook\n\n## Instructions for AI assistant\n\n- `CLAUDE.md` is the canonical instruction file, and `AGENTS.md` is a symlink to it. Edit `CLAUDE.md`, never `AGENTS.md`.\n- Instructions are scoped by directory: the file nearest a path applies to it, and adds to the root file rather than contradicting it. Read `platform/wab/CLAUDE.md` before changing anything under `platform/wab`.\n- Do not worry about styling/formatting. All files will be formatted to the same style in git hooks, which husky manages via the generated, gitignored `.husky/_` directory. In a fresh worktree that directory doesn't exist and git silently skips all hooks, so run `pnpm install` at the worktree root before your first commit.\n- When searching files, you should almost never look through node_modules/ files and other gitignored files unless you have a explicit reason to.\n- When you review a pull request or a diff, these files are the conventions to review it against.\n","packages/auth-api/tsconfig.json":"{\n \"extends\": \"../../tsconfig.types.json\",\n \"include\": [\"./src\"],\n \"compilerOptions\": {\n \"outDir\": \"./api/tsc\"\n }\n}\n","packages/auth-react/README.md":"# @plasmicapp/auth-react\n\nLibrary for handling auth flows in Plasmic apps.\n","packages/auth-api/README.md":"# @plasmicapp/auth-api\n\nLibrary for handling auth flows in Plasmic apps.\n","ai/skills/plasmic-designer/SKILL.md":"---\nname: plasmic-designer\ndescription: Build and modify Plasmic Studio designs using copilot tools via Chrome DevTools MCP. First argument should be a project ID, followed by the design request. Use this skill whenever the user mentions Plasmic, Plasmic Studio, visual web builder, or asks to design, build, edit, or modify UI components, pages, sections, or layouts inside a Plasmic project. Also trigger when the user references a Plasmic project ID, wants to add/remove/restyle elements in a visual editor, or asks about Plasmic component props, variants, slots, or tokens — even if they don't say \"Plasmic\" explicitly but describe visual design work that implies it.\nallowed-tools: mcp__chrome-devtools__evaluate_script mcp__chrome-devtools__navigate_page mcp__chrome-devtools__take_screenshot mcp__chrome-devtools__list_pages\nmetadata:\n version: \"1.3.3\"\n---\n\n# Plasmic Designer\n\nSkill Version: 1.3.3\n\nControl Plasmic Studio through Chrome DevTools MCP to build and modify production-ready interfaces.\n\n## Arguments\n\n`$ARGUMENTS` should contain a **project ID** as the first word, followed by the design request.\n\nExample: `/plasmic-designer j2Bm3mrbGNKsXVW3Wf5KpP Add a hero section to the Homepage`\n\nIf no project ID is provided, or if the conversation references multiple projects and it's unclear which one to use, ask the user to confirm the project ID before proceeding.\n\n## Setup\n\nThe studio base URL is `https://studio.plasmic.app` by default. Only use `http://localhost:3003` if the user explicitly mentions localhost, a local dev server, or a local environment.\n\n1. **Navigate to the project** using `navigate_page` to open `{baseUrl}/projects/{projectId}/`\n\n2. **Wait for studio to load and identify the session** — the studio takes a few seconds to initialize. Poll until `window.PLASMIC_AI_TOOLS` is available, then call `identify()` once, before any other tool.\n\n ```javascript\n async () => {\n for (let i = 0; i < 30; i++) {\n if (window.PLASMIC_AI_TOOLS) {\n return await window.PLASMIC_AI_TOOLS.identify({\n model: \"\",\n client: \"\",\n outputFormat: \"\",\n });\n }\n await new Promise((r) => setTimeout(r, 1000));\n }\n return {\n success: false,\n error: { message: \"Studio failed to load.\" },\n };\n };\n ```\n\n Fields (all required):\n\n - `model` — Model name as known to the agent (e.g. `claude-opus-4-7`, `anthropic/claude-sonnet-4-6`, `gpt-5.3-codex`).\n - `client` — AI client/CLI invoking the tool (e.g. `claude-code`, `claude-code@1.x`, `opencode`, `cursor`, `cline`).\n - `outputFormat` — Preferred format for tool output, `\"json\"` or `\"xml\"`.\n\n Pass `\"unknown\"` for any required string field you cannot reliably identify.\n\n If `success` is false, inform the user and stop.\n\n## Workflow\n\nFollow an explore-first pattern for every request:\n\n1. **Understand** — `read` the current state before changing anything; prefer reusing existing components over new HTML.\n2. **Plan** — For complex requests, break the work into steps before acting.\n3. **Execute** — Make changes with the appropriate tools.\n4. **Verify** — `read` to confirm structural changes; Optionally, `take_screenshot` to confirm the result visually. Tools edit a page or component without opening its arena, so `navigate` to it first.\n\n## Using the tools\n\nThe toolset is exposed at runtime and is the source of truth — **introspect it, don't rely on a hardcoded list.** `_meta` is a `Record` keyed by tool name:\n\n```ts\ninterface CopilotToolMeta {\n toolName: string;\n title: string;\n description: string;\n inputSchema: JSONSchema7; // JSON Schema (draft-07)\n outputSchema: JSONSchema7; // shape of a successful `output`\n}\n```\n\nRead a compact tool catalog once with `evaluate_script`. Omit schemas from this initial result because they are much larger:\n\n```javascript\n() =>\n Object.fromEntries(\n Object.entries(window.PLASMIC_AI_TOOLS._meta).map(\n ([name, { title, description }]) => [name, { title, description }],\n ),\n );\n```\n\nBefore using a tool, inspect its `inputSchema` and treat it as authoritative for field names, required fields, enums, and nesting, for example `() => window.PLASMIC_AI_TOOLS._meta.read.inputSchema`. Inspect only the relevant `outputSchema` when its result shape matters.\n\nCall a tool with an async arrow function (tools return Promises), passing one input object that conforms to its schema:\n\n```javascript\nasync () => await window.PLASMIC_AI_TOOLS.({\n /* fields per window.PLASMIC_AI_TOOLS._meta..inputSchema */\n});\n```\n\nEvery call resolves to a `CopilotToolCallResult`:\n\n```ts\ntype CopilotToolCallResult =\n | { success: true; output: string }\n | {\n success: false;\n error: { message: string; type: \"TOOL_NOT_FOUND\" | \"EXECUTION_FAILED\" };\n };\n```\n\nCheck `success` each time; on a UUID error, re-read for fresh UUIDs and retry.\n\nCall `read` before any mutation to get project structure and the UUIDs every other tool needs. Its output is usually XML: parse it for UUIDs, props, variants, and slots, and read selectively (specific components/elements) on large projects. After a successful mutation the canvas updates automatically.\n\n## Legacy Data Query Migration\n\nOnly when asked, read `references/query-migration.md` before migrating. Migrate only the named query; for a component-wide request, assess every `legacyDataQueries` entry.\n\n## Components & Variants\n\n### Reusing Existing Components\n\nWhen you read a component, review its props, variants, slots, element tree and per-variant style overrides before using it.\n\nTo use a component in insertHtml:\n\n```html\n\n Slot content here\n\n```\n\n- `data-plasmic-component` must exactly match the component name from `read()` (case-sensitive).\n- `data-plasmic-project` (optional) is the id of the imported project the component comes from. Omit it for components in the current project; set it to use a component from an imported project.\n- `data-plasmic-name` (optional) names this component instance in the tree. It's a semantic name picked up by Plasmic codegen to override the element in the generated code.\n- `data-props` is a JSON object for both props and variant activations. Boolean variants: `\"group\": true`. Enum variants: `\"group\": \"optionName\"`.\n- `` children fill named slots; its children become the slot content.\n- **Only layout/position styles work on instances**: width, height, min/max sizing, margin, position, top/left/bottom/right, z-index, order, align-self, flex-grow/shrink, opacity, display (only `none`), transform, and transition properties. Background, padding, color, font, border, etc. are ignored on instances — use `changeElement` on the component's root element instead. This is a Plasmic platform constraint, not a preference.\n\n## Dynamic Data\n\nText, attributes, and component props can be bound to runtime data — `$props`, `$state`, `$ctx` (page params/query), `$queries` / `$q` (data query results), and repetition locals (`currentItem`, `currentIndex`).\n\n- Write bindings as inline `{{ jsExpr }}` interpolation. Content is static by default; wrapping JS in `{{ }}` makes it dynamic (also used for non-string literals, e.g. `\"{{ 10 }}\"`).\n- Before binding, `read({ dataContext: [{ componentUuid, elementUuid }] })` to see which paths exist, then drill in with `paths` / `maxArrayItems`. Reference only paths it returns.\n- Repetition: `data-repeat=\"{{ $q.myQuery.data }}\"` in `insertHtml`, or `repeat: { collection: \"...\" }` in `changeElement`; bind the subtree with `{{ currentItem.* }}`. The repeated element is duplicated once per item, so put row or wrapping layout on its parent.\n- Visibility: `data-visible-if=\"{{ ... }}\"` / `data-visibility=\"displayNone\"`, or `visibility: { showIf: \"...\" }` in `changeElement`.\n- A prop wired to the enclosing component's prop reads back as `{{ $props. }}`, and a link-to-page destination as its URL with dynamic parts inlined (e.g. `/products/{{ $state.slug }}`).\n\n## HTML Code Guidelines\n\nBefore generating HTML, read `references/html-constraints.md` for the full set of rules. The key points:\n\n- Use `