SKILL.md file, scripts, and reference material. When a request matches an assigned Skill, the agent can load its instructions and use the included resources to complete the work.
Use Skills for repeatable procedures, calculations, file processing, report generation, and other tasks that need more guidance than the agent’s main prompt should contain. Integrations connect an agent to an external system. Skills tell the agent how to approach and complete specialized work.
You can add a curated Skill from the Skills marketplace or upload your own Skill package. Both types appear in the workspace’s Skills list and can be inspected before you assign them to an agent.
Adding a Skill from the Marketplace
The Skills marketplace contains curated Skills that can be added to the current workspace. You can review each Skill’s instructions and readable package files before adding it.1
Open the Marketplace
Navigate to the Skills tab, click Add New, and select Browse marketplace.
2
Find a Skill
Search by name or description. Skills already available in the workspace are marked Added.
3
Inspect the Skill
Select a Skill to open its preview. Review the
SKILL.md, package details, and included files. Use Preview to read the rendered instructions or Code to inspect and copy the raw SKILL.md.Select a readable file to inspect its contents. This is useful for checking scripts and reference material before giving an agent access to the Skill.4
Add the Skill
Click Add to workspace from the preview. You can also select multiple Skills in the marketplace table and click Add selected to workspace.
Adding a marketplace Skill makes the shared package available in the current workspace. It does not create an editable copy. Marketplace Skills cannot be edited in VIVI.
Uploading a Custom Skill
Upload a custom Skill when your organization has its own instructions, scripts, or reference files. VIVI accepts a singleSKILL.md file or a .zip package.
1
Start the Upload
Navigate to the Skills tab, click Add New, and select Upload a skill.
2
Choose a File
Upload a file named
SKILL.md or a .zip archive with SKILL.md at the top level. Markdown files with any other name are rejected.3
Complete the Upload
Review the selected file and click Upload. VIVI validates the package and uses the name and description from the
SKILL.md frontmatter.SKILL.md Format
EverySKILL.md must begin with YAML frontmatter containing name and description. The name may contain lowercase letters, numbers, and hyphens. Write the remaining Markdown as direct instructions that tell the agent when and how to use the Skill.
ZIP Package Format
Use a ZIP package when the Skill needs scripts or additional reference material. KeepSKILL.md at the top level of the archive.
- No more than 100 files
- No file larger than 1 MB when extracted
- No more than 10 MB total when extracted
SKILL.mdsaved as UTF-8 text
Inspecting a Skill
Inspect a Skill to understand its instructions and review the files an agent may use. You can inspect uploaded and marketplace Skills from the workspace, and marketplace Skills before adding them.Inspect an Installed Skill
1
Open the Skill
Navigate to the Skills tab and select a Skill from the table.
2
Review the Details
The detail page shows the Skill’s name, description, source, package size, and creation details. It also displays author, version, and license information when the package provides them.
3
Review Package Files
Open the Files section to see the readable files included in the package. Select a file to view its path, size, and contents. Use the copy control when you need to review the content elsewhere.
4
Review SKILL.md
Use Preview to read the frontmatter and rendered instructions. Use Code to inspect or copy the complete raw file.
The file inspector displays readable text files. Binary files are not displayed. Large text files may be shortened in the preview and marked as truncated. Download the package when you need to inspect files that are not shown in full.
Assigning Skills to an Agent
A Skill must be added to the workspace before it can be assigned to an agent.1
Open the Agent
Navigate to the Agents tab and create or edit the agent that needs the Skill.
2
Select Skills
Open the agent’s Skills section and select the Skills the agent should be able to use.
3
Save and Test
Save the agent, then test requests that should and should not use each assigned Skill. Confirm that the agent loads the Skill only for relevant work and follows its instructions correctly.
Skills are available to text-based agent conversations. Realtime voice conversations do not load assigned Skills.
Managing Skills
The Source column identifies how each Skill was added:
To update an uploaded Skill, select Edit and upload a replacement
SKILL.md or ZIP package. The name in the replacement frontmatter must match the existing Skill. To use a different name, upload the package as a new Skill.
Marketplace Skills cannot be edited. If you need different instructions or files, create and upload your own package. Removing a marketplace Skill removes it only from the current workspace. The Skill remains available in the marketplace and in other workspaces.
Before VIVI deletes or removes a Skill, the confirmation dialog lists any agents that currently use it. Those agents will lose access to the Skill after removal.
Best Practices
- Inspect
SKILL.md, scripts, and reference files before adding or assigning a Skill. - Confirm that the Skill’s purpose, author, version, and license meet your organization’s requirements.
- Assign only the Skills an agent needs for its role.
- Keep each custom Skill focused on one type of work and state when the agent should use it.
- Make scripts validate their inputs and return useful errors for missing or invalid data.
- Never include passwords, API keys, access tokens, customer data, or other secrets in a Skill package.
- Use an integration when the agent needs access to an external system. Use a Skill to provide the procedure or supporting files for completing the work.
- Test every uploaded or marketplace Skill with realistic requests before using it in a live agent.
- Review the affected-agent warning before replacing, deleting, or removing a Skill.