toolkit-publish-troubleshooting

Diagnose and resolve VIVERSE PlayCanvas Toolkit deployment failures.

2|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/viverseofficial/viverse-sdk-skills --skill toolkit-publish-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: toolkit-publish-troubleshooting
Source: https://github.com/viverseofficial/viverse-sdk-skills/tree/main/skills/viverse-playcanvas-toolkit/skills/toolkit-publish-troubleshooting
Command: npx skills add https://github.com/viverseofficial/viverse-sdk-skills --skill toolkit-publish-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves technical bottlenecks in the VIVERSE PlayCanvas Toolkit pipeline, helping users identify why their local builds, sync processes, or publishing attempts are failing.

Core Features & Use Cases

  • Pipeline Diagnosis: Pinpoints failures across local builds, PlayCanvas sync, and VIVERSE CLI publishing.
  • Configuration Validation: Checks for common errors like incorrect app IDs, branch mismatches, or authentication issues.
  • Use Case: If your local changes are not appearing in the VIVERSE world or your CLI publish command returns an error, this skill guides you through the specific configuration or sync step that is blocking the deployment.

Quick Start

Describe the specific step that failed and the command or action you performed to receive immediate troubleshooting guidance.

Frequently Asked Questions about toolkit-publish-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my PlayCanvas sync not updating local changes to the VIVERSE world?

PlayCanvas sync failures usually stem from incorrect app identity configuration or authentication state mismatches. Validating your project's app ID, checking branch alignments, and verifying authentication states will resolve the local-to-remote synchronization block.

How do I fix VIVERSE CLI publishing errors during deployment?

To fix VIVERSE CLI publishing errors, diagnose the specific deployment step that failed by validating your command execution path. Checking for common configuration errors like incorrect app IDs or branch mismatches ensures successful content delivery.

What causes local-to-remote synchronization failures in the VIVERSE PlayCanvas Toolkit?

Local-to-remote synchronization failures are caused by authentication issues, incorrect pathing, or app identity mismatches. Diagnosing these specific configuration states pinpoints the exact pipeline bottleneck preventing your local builds from deploying.

How do I validate PlayCanvas project configuration for VIVERSE deployment?

Validate PlayCanvas project configuration by checking for incorrect app IDs, branch mismatches, and authentication states. Confirming these identity and pathing requirements ensures your local builds successfully pass through the CLI publishing pipeline.

What should I check when VIVERSE deployment troubleshooting is not working?

When VIVERSE deployment troubleshooting is not working, check your authentication states, local pathing, and app identity requirements. Pinpointing the exact failed step across local builds, PlayCanvas sync, or CLI publishing isolates the blocking configuration error.