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

# nut skill

> Manage AI skills (agents)

# `nut skill`

Manage AI skills (agents) in your Coconut instance.

```bash theme={null}
nut skill [command]
```

**Aliases:** `skill`, `skills`

## Overview

Skills (also known as agents) are AI assistants that help automate tasks in your Coconut instance. Each skill has a specific purpose, capabilities, and configuration that determines how it interacts with your codebase and tasks.

<Note>
  `nut skill` manages skills in the current local workspace. To list, create, update, or delete skills on a remote peer Coconut through the Coconut Dashboard, use [`nut coconut skill`](/cli/coconut).
</Note>

***

## `nut skill list`

List all skills in your Coconut instance.

```bash theme={null}
nut skill list
nut skill ls
```

**Aliases:** `list`, `ls`

This displays a table of all configured skills with their IDs, names, and descriptions.

**Examples:**

```bash theme={null}
nut skill list
nut skill ls
```

***

## `nut skill show`

Show detailed information about a specific skill.

```bash theme={null}
nut skill show <id>
```

**Arguments:**

* `id` - The skill ID

**Examples:**

```bash theme={null}
nut skill show skill-001
```

This displays:

* Skill configuration
* Capabilities and permissions
* Recent activity
* Associated tasks

***

## `nut skill create`

Create a new skill.

```bash theme={null}
nut skill create <name> <description> [options]
```

**Arguments:**

* `name` - Name of the skill
* `description` - Description of what the skill does

**Examples:**

```bash theme={null}
# Create a code review skill
nut skill create "Code Reviewer" "Reviews pull requests for code quality and best practices"

# Create a documentation skill
nut skill create "Documentation Writer" "Generates and updates technical documentation"

# Create a testing skill
nut skill create "Test Engineer" "Writes and maintains unit and integration tests"
```

<Tip>
  Choose descriptive names and clear descriptions to help skills understand their role and responsibilities. Be specific about what the skill should focus on.
</Tip>

***

## `nut skill update`

Update an existing skill's configuration.

```bash theme={null}
nut skill update <id> [options]
```

**Arguments:**

* `id` - The skill ID to update

**Examples:**

```bash theme={null}
nut skill update skill-001
```

This opens an interactive editor to modify the skill's:

* Name and description
* Capabilities and permissions
* Instructions and prompts
* Model preferences

***

## `nut skill delete`

Delete a skill.

```bash theme={null}
nut skill delete <id>
```

**Arguments:**

* `id` - The skill ID to delete

**Examples:**

```bash theme={null}
nut skill delete skill-001
```

<Note>
  Deleting a skill is permanent. The skill's configuration and history will be removed, but tasks it worked on remain intact.
</Note>

***

## `nut skill registry`

Browse and install skills from the Coconut Registry.

```bash theme={null}
nut skill registry
```

This opens an interactive interface to explore pre-built skills from the Coconut Registry that you can install and use in your projects.

**Examples:**

```bash theme={null}
nut skill registry
```

### Available Registry Skills

The Coconut Registry includes skills for:

* Code review and quality assurance
* Documentation generation
* Testing and QA
* Refactoring and optimization
* Security analysis
* And more...

<Card title="Coconut Registry" icon="store" href="https://registry.coconut.dev">
  Explore the full collection of skills in the Coconut Registry
</Card>

***

## Skill Workflow Example

<Steps>
  <Step title="Browse the registry">
    ```bash theme={null}
    nut skill registry
    ```

    Find a skill that matches your needs or get inspiration for creating your own.
  </Step>

  <Step title="Create a custom skill">
    ```bash theme={null}
    nut skill create "API Developer" "Specializes in designing and implementing RESTful APIs"
    ```
  </Step>

  <Step title="Assign to tasks">
    When creating tasks, you can assign specific skills to work on them, or let Coconut automatically match skills to tasks.
  </Step>

  <Step title="Monitor and refine">
    ```bash theme={null}
    nut skill show skill-001
    ```

    Review the skill's work and update its configuration as needed.
  </Step>
</Steps>

## Best Practices

<AccordionGroup>
  <Accordion title="Create focused skills">
    Each skill should have a clear, specific purpose. Instead of a general "Developer" skill, create focused skills like "Frontend Developer", "API Developer", "Database Engineer", etc.
  </Accordion>

  <Accordion title="Provide detailed descriptions">
    The more context you give in the skill description, the better it will understand its role and make appropriate decisions.
  </Accordion>

  <Accordion title="Start with registry skills">
    Before creating custom skills, check the Coconut Registry for pre-built skills that match your needs. You can always customize them later.
  </Accordion>

  <Accordion title="Review and iterate">
    Regularly review skill performance and update configurations based on actual usage. Skills can be refined over time to better match your workflow.
  </Accordion>
</AccordionGroup>