Skills
Sharing Skills
Share custom skills with other CRHQ instances — package skills as downloadable bundles with optional password protection.
Custom skills can be shared with other CRHQ instances via shareable links. When you share a skill, CRHQ packages everything — instructions, scripts, configuration files — into a downloadable bundle that can be installed on any other instance.
Creating a Share Link
- Go to Settings → Skills
- Find a custom skill (skills with the blue user icon)
- Click the Share button in the row actions
- Choose access type:
- Anyone with the link — no password required
- Password protected — viewers must enter a password to access and download
- Click Create Share Link
A unique URL is generated that you can send to anyone.
Shared skills are accessible at:
https://your-instance.crhq.ai/skill/{shareHash}
The share page shows the skill name, description, version, and bundle size, along with a download button.
What Gets Shared
The share bundle is a .tar.gz file containing:
- skill.json — Metadata (name, description, version, timestamps)
- SKILL.md — The full skill instructions from the database
- scripts/ — All script files from the skill folder
- package.json — npm dependencies (if the skill uses any)
- Any other files in the skill folder (templates, configs, etc.)
Info: node_modules/, .env files, and .git directories are automatically excluded from the bundle. Dependencies are reinstalled when the skill is imported on the receiving end.
Password Protection
When sharing with a password:
- Choose Password protected in the share dialog
- Set or auto-generate a password
- Share both the URL and the password with the recipient
- The recipient must enter the password on the share page before they can download
Updating a Shared Skill
If you update your skill after sharing it, the share link keeps the same URL but you can update the bundle:
- Open the share dialog for the skill (click the Share button again)
- Click Update Bundle
- The bundle is re-packaged with the latest skill content
- Anyone using the same link now gets the updated version
This means you can share a link once and keep it up to date as the skill evolves.
Revoking a Share
To stop sharing a skill:
- Open the share dialog for the skill
- Click Revoke
- The link immediately stops working
After revoking, you can create a new share link — it will have a different URL.
Installing a Shared Skill
When you receive a shared skill link from another instance:
- Open the share URL in your browser
- Enter the password if required
- Download the
.tar.gz bundle
- Ask your Skill Builder agent to install it — paste the download URL or share page URL and the agent will handle extraction, file placement, dependency installation, and database registration
Tip: You can paste the share page URL directly to the Skill Builder agent. It knows how to derive the download endpoint from the share URL and will install everything automatically.
What Can Be Shared
Only custom skills (user-created) can be shared. System skills and store skills from CRHQ Hub cannot be shared directly — clone them to a custom skill first, then share the copy.
Use Cases
- Team collaboration — Share a skill you built with a colleague on another instance
- Cross-organization sharing — Send a skill to a partner or client
- Skill distribution — Build a skill once, deploy it across multiple instances
- Backup and portability — Download a skill bundle as an offline backup