> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vivi.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

Skills give your agents **specialized capabilities and computational power**, extending what they can do beyond their base configuration. Think of Skills as giving each agent its own mini-computer, enabling it to write and execute scripts, process complex data, and solve problems in real-time.

Skills transform your agents from simple conversational interfaces into intelligent problem-solvers. They **enable real-time computation** like loan calculations, data parsing, and report generation.

***

## Setting up Skills

<video autoPlay muted loop playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/ksg-ea85c748/c3RyT_u3xoy2Iw5F/videos/skills.mp4?fit=max&auto=format&n=c3RyT_u3xoy2Iw5F&q=85&s=7c5caf6e878f3e0803abf7d38b841641" data-path="videos/skills.mp4" />

Navigate to the **Skills** tab and click **Add New**. You'll be directed to upload a `.zip` or `SKILL.md` file containing a complete skill definition. This allows you to use skills that you've:

* Received from another team member
* Migrated from another system
* Developed locally and want to deploy
* Found from a pre-built template

Once your skill is uploaded, it will appear in your Skills tab under the name that was uploaded. Skills are immediately available to assign to your agents once created by heading to the Agents tab and entering the edit screen for the agent you wish to have the new Skill.

***

## Skill File Format

Uploaded skill files (`.zip` or `SKILL.md`) should contain the following:

### SKILL.md Format

```markdown theme={null}
# Skill Name

## Description
A clear explanation of what this skill does and when it should be used.

## Inputs
- **input_name** (type): Description of this input
- **another_input** (type, optional): Description with default value

## Outputs
- **output_name** (type): Description of what this returns

## Logic
Detailed instructions for how the skill should process inputs and generate outputs.
This can include:
- Step-by-step procedures
- Business rules and conditions
- Edge case handling
- Example scenarios

## Examples
### Example 1: Basic Usage
**Input:** 
- loan_amount: 250000
- interest_rate: 4.5
- term_years: 30

**Output:**
- monthly_payment: 1266.71

### Example 2: Edge Case
**Input:**
- loan_amount: 0
- interest_rate: 4.5
- term_years: 30

**Output:**
- Error: "Loan amount must be greater than zero"
```

### .zip File Format

For more complex skills that require multiple scripts and lengthy documentation:

```text theme={null}
skill-name.zip
├── SKILL.md              # Main skill definition (required)
├── references.md         # Detailed examples for the agent to review    
└── scripts/              # Actual code for the agent to use
    ├── script1.py
    └── script2.py
```

***

## Best Practices

* Ensure that your skill files contain clear, detailed instructions so that your agents know exactly how to use your skills