Skip to main content

​
nut skill

Manage AI skills (agents) in your Coconut instance. 
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.

​
nut skill list

List all skills in your Coconut instance. 
nut skill list
nut skill ls
Aliases: list, ls This displays a table of all configured skills with their IDs, names, and descriptions. Examples: 
nut skill list
nut skill ls

​
nut skill show

Show detailed information about a specific skill. 
nut skill show <id>
Arguments:
  • id - The skill ID
Examples: 
nut skill show skill-001
This displays:
  • Skill configuration
  • Capabilities and permissions
  • Recent activity
  • Associated tasks

​
nut skill create

Create a new skill. 
nut skill create <name> <description> [options]
Arguments:
  • name - Name of the skill
  • description - Description of what the skill does
Examples: 
# 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"
Choose descriptive names and clear descriptions to help skills understand their role and responsibilities. Be specific about what the skill should focus on.

​
nut skill update

Update an existing skill’s configuration. 
nut skill update <id> [options]
Arguments:
  • id - The skill ID to update
Examples: 
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. 
nut skill delete <id>
Arguments:
  • id - The skill ID to delete
Examples: 
nut skill delete skill-001
Deleting a skill is permanent. The skill’s configuration and history will be removed, but tasks it worked on remain intact.

​
nut skill registry

Browse and install skills from the Coconut Registry. 
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: 
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…

Coconut Registry

Explore the full collection of skills in the Coconut Registry

​
Skill Workflow Example

1

Browse the registry

nut skill registry
Find a skill that matches your needs or get inspiration for creating your own.
2

Create a custom skill

nut skill create "API Developer" "Specializes in designing and implementing RESTful APIs"
3

Assign to tasks

When creating tasks, you can assign specific skills to work on them, or let Coconut automatically match skills to tasks.
4

Monitor and refine

nut skill show skill-001
Review the skill’s work and update its configuration as needed.

​
Best Practices

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.
The more context you give in the skill description, the better it will understand its role and make appropriate decisions.
Before creating custom skills, check the Coconut Registry for pre-built skills that match your needs. You can always customize them later.
Regularly review skill performance and update configurations based on actual usage. Skills can be refined over time to better match your workflow.