prag-matt-ic/threenix-plugin

threenix-add-component

Discover and add Threenix components, hooks, WebGPU scene foundations, and visual effects using the Threenix MCP library.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/prag-matt-ic/threenix-plugin --skill threenix-add-component

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Add a Threenix Component

Use the live Threenix library to integrate the requested resource into the target project. Accept a resource slug after $threenix-add-component, or a natural-language description.

Workflow

  1. Read the target repository's instructions and inspect its package manager, installed dependencies, scene boundary, renderer, camera, controls, postprocessing, and asset handling.
  2. Call list_components on the threenix MCP server. Match the request against its slugs, summaries, and tags, then call get_component_reference for the selected slug. Fetch only references needed for the request. Ask for clarification when materially different matches or integration sites remain plausible. If either tool is unavailable or fails, explain the problem and stop; do not reconstruct the reference from memory or bundled sources.
  3. Read the returned integrationNotes before editing and check installed APIs against the reference's dependencies. Do not migrate a WebGL renderer, silently upgrade existing dependencies, remove competing camera controllers, or replace host infrastructure to apply a reference. Reuse a compatible Canvas; add one only when the requested setup needs it.
  4. Choose one destination root near the target scene. Write the returned files[] beneath it, preserving relative paths: write utf-8 content verbatim and decode base64 content. Check for existing files before overwriting local changes. For downloads[], download each URL directly to its returned path without loading binary data into model context. Verify HTTP success and all expected files before integrating; report missing or failed assets. Reject absolute paths or paths escaping the chosen root.
  5. Follow the reference's integration and runtime guidance. Preserve host camera, renderer, controls, scene, loading UI, and postprocessing unless the requested resource explicitly owns that responsibility. Keep host wiring outside copied source; customize reference source only where its notes permit it. Never copy demo-only infrastructure.
  6. Add only absent dependency names using the project's package manager and returned versions. Install dependencies as runtime dependencies and devDependencies as development dependencies. Preserve existing ranges and report incompatible APIs instead of silently replacing versions.
  7. Run the narrowest relevant type-check or build and the resource-specific runtime checks. Report unperformed checks and unresolved compatibility or asset errors; a successful build alone does not establish a visual or performance improvement.

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills