meshy-dev/meshy-3d-agent

meshy-3d-generation

Generates and edits digital 3D assets with the Meshy CLI: text-to-3D and image-to-3D models, texturing, remeshing and LODs, UV unwrapping, format conversion (GLB, FBX, OBJ, USDZ, STL, 3MF, Blender), rigging, animation, motion clips from text and reference i…

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/meshy-dev/meshy-3d-agent --skill meshy-3d-generation

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Meshy 3D Generation

Use Meshy CLI 0.8 (0.8.6 or later) to turn the user's request into a delivered asset. Completion means saving the requested files in the requested location and inspecting an available preview. Login or task submission alone is not completion. Choose the shortest suitable pipeline and reuse existing assets for follow-ups.

Read what this request needs

NeedReference
CLI runner, credentials, or output locationSetup
Generation and the models to pair for a project, texturing, remeshing, conversion, scale, or 2D imagesPipelines
Rigging, animation, or generated motionAnimation
Cost, waiting, preview, delivery, or finding a previous modelDelivery
A chat that shows images or web pages (desktop or IDE agent apps), at delivery or when the user asks to see the modelVisual hosts
Failed or uncertain operationTroubleshooting

Read the relevant section when needed; recipes are examples to adapt to the requested result, not a requirement to execute every stage. An untextured model skips texture generation; an existing GLB needs no extra format conversion. Use command help when parameters are uncertain.

First use and authorization

In DeepSeek Harness with the Meshy plugin (DSH_MESHY_CLI is set) run every command as "$DSH_MESHY_NODE" "$DSH_MESHY_CLI" …, never a meshy on PATH, install nothing, and sign in with the meshy_sign_in tool. Everywhere else run meshy --version before the first command, without asking; when it is missing or older than 0.8.6, install it with npm install -g meshy-cli@0.8 and say so in one line (Setup, section 1).

Reuse a verified session. If login is needed, run auth login --device (with --region cn for a user in mainland China) as Setup, section 3 describes: show its URL and user code in commentary/progress, not a final answer, wait on that same command in this turn, verify auth status, then continue the original request. Browser approval stays with the user; credentials never belong in chat, and only the CLI touches its config directory.

Execution boundaries

  • Run API, upload, download and mesh operations through the CLI. Local inputs have a 50 MiB

limit, and a local model must be GLB or glTF (rigging, UV unwrap and multicolor: GLB); use the supported URL input route for anything else.

  • Use --format json --no-update-check on every command: stdout is one meshy.cli/v1 envelope,

auth included. Resolve WORKSPACE from the user's output path and pass it to writes.

  • Know what the model is for before the first paid create: a game asset, a character to rig, a

render, a 3D print. If the user hasn't said, ask once; the answer picks the route and the models (Pipelines). A game asset or a face-count budget means smart topology, not a standard model remeshed down.

  • Submit once with create --async, retain the owning resource and ID, then wait on that

task. Keep the agent turn active while awaiting a running command. Follow Troubleshooting on timeout or unknown submission; these do not authorize another paid create.

  • Without a usable photo, recommend making a reference image first and building the model

from it; text-to-3d is the quicker alternative (Pipelines, Start from an image).

  • Continue work within the user's approved scope and budget. Propose additional paid stages

or reruns before spending; Delivery specifies estimates and balance checks.

Deliver

Download only needed assets. Inspect and show a preview when available; a missing preview must not prevent delivery or be described as inspected. Delivery covers earlier-stage preview lookup and actual charges. Report the result and any concrete limitation; a rendered image does not establish topology quality or provide a 3D viewer. Where your chat shows images or web pages, Visual hosts covers showing the preview and the model there.

같은 저장소의 Skills

더 많은 Skills

모든 Skills