velt-setup-best-practices
Velt collaboration SDK setup guide for React, Next.js, Angular, Vue, and HTML applications. Use this skill when setting up Velt for the first time, configuring VeltProvider, implementing user authentication with authProvider and JWT tokens, initializing document collaboration with setDocuments, adding VeltUserInviteTool for share & invite flows, or debugging Velt setup issues. Triggers on any task involving Velt installation, VeltProvider configuration, auth token generation, document identity setup, share/invite components, or project structure for Velt integration — even if the user doesn't explicitly mention "setup".
How do I install this agent skill?
npx skills add https://github.com/velt-js/agent-skills --skill velt-setup-best-practicesIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive and secure guidelines for setting up the Velt collaboration SDK. It correctly identifies and warns against critical security anti-patterns, such as exposing authentication tokens in client-side code, and provides secure alternatives using server-side environment variables and JWT token generation via the vendor's official APIs.
- Socketwarn
3 alerts: gptAnomaly, gptSecurity
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerwarn
13/28 files flagged
What does this agent skill do?
Velt Setup Best Practices
Comprehensive setup guide for Velt collaboration SDK. Contains 25 rules across 9 categories covering installation, authentication, document setup, and project organization.
When to Apply
Reference these guidelines when:
- Setting up Velt in a new React, Next.js, Angular, Vue, or HTML project
- Configuring VeltProvider and API keys
- Implementing user authentication with Velt (userId, organizationId)
- Setting up JWT token generation for production
- Initializing documents with documentId
- Organizing Velt-related files in your project
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Installation | CRITICAL | install- |
| 2 | Provider Wiring | CRITICAL | provider- |
| 3 | Identity | CRITICAL | identity- |
| 4 | Document Identity | CRITICAL | document- |
| 5 | Config | HIGH | config- |
| 6 | Project Structure | MEDIUM | structure- |
| 7 | Routing Surfaces | MEDIUM | surface- |
| 8 | Components | MEDIUM | component- |
| 9 | Debugging & Testing | LOW-MEDIUM | debug- |
How to Use
Read individual rule files for detailed explanations and code examples:
rules/react/installation/install-react-packages.md
rules/react/provider-wiring/provider-velt-provider-setup.md
rules/shared/_sections.md
Each rule file contains:
- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Verification checklist
- Source pointers to official docs
Compiled Documents
AGENTS.md— Compressed index of all rules with file paths (start here)AGENTS.full.md— Full verbose guide with all rules expanded inline
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/velt-js/agent-skills/velt-setup-best-practices">View velt-setup-best-practices on skillZs</a>