This topic describes how to add custom skills to digital employees.
What Are Digital Employee Skills?
A digital employee skill (Skill) is a reusable instruction module. It teaches digital employees to complete specific tasks by following a fixed process. Skills encapsulate expertise, workflows, and best practices into standardized capability units. This enables an efficient collaboration model: write once, invoke many times.
Features
Progressive loading: Digital employees load full skill content only when needed, which saves context space.
Knowledge reuse: Encapsulate expertise into reusable modules, ensuring consistent execution.
On-demand triggering: Automatically match and activate relevant skills based on conversation content.
Easy maintenance: Create and modify skills using Markdown file format, no programming required.
Terms
Before using digital employee skills, understand these basic concepts.
Term | Description |
Skill | A skill module, a folder containing instructions, scripts, and resources. Digital employees can dynamically load it to complete specific tasks. |
SKILL.md | The skill definition file, a Markdown file containing metadata and execution instructions. It is the core of each skill. |
Metadata (Frontmatter) | YAML-formatted configuration at the top of the SKILL.md file. It defines basic information such as skill name and description. |
Trigger condition | Matching rules that digital employees use to determine whether to activate a skill based on conversation content. |
How Skills Work
Skills use a progressive loading mechanism to efficiently manage context:
Discovery phase: Digital employees load only the name and description of each skill when starting.
Activation phase: When a user task matches a skill's description, the complete SKILL.md instructions are loaded.
Execution phase: Tasks are executed according to instructions, loading reference files as needed.
Note: Digital employee Skills currently do not support loading and running scripts.
Scenarios
Scenario | Description |
Service saturation analysis | Evaluate resource usage (such as CPU, memory, and connection pool) for services. Identify performance bottlenecks. |
K8s O&M operations | Perform change operations on Kubernetes clusters, such as scaling, restarting, and image updates. |
Service release checks | Automatically check health status, traffic switching, and configuration changes before and after service release. |
Cost analysis and optimization | Analyze cloud resource usage. Identify idle resources and optimization opportunities. |
Health check | Regularly check core metrics such as service availability, latency, and error rates. |
Safe rollback | Quickly perform rollback operations during service abnormalities. Recover to a stable version. |
Add Custom Skills
This topic describes how to add custom skills to digital employees.
Prerequisites
The digital employee was successfully created.
You must have skill management permissions.
Step 1: Access the Skill Management Interface
Select the target digital employee.
On the skill management interface, add a skill.
Step 2: Fill in Basic Skill Information
Fill in the following fields:
Field | Required | Description |
Skill name | Yes | The unique identifier for the skill. It supports only lowercase letters, numbers, and hyphens. The maximum length is 64 characters. |
Display name | Yes | The name displayed for the skill on the interface. |
Description | Yes | The functional description and applicable scenarios for the skill. The maximum length is 512 characters. |
Step 3: Write Skill Content
Write skill content according to the SKILL.md format specification. The basic format is as follows:
---
name: skill-name
description: Functional description and applicable scenarios for the skill
---
# Skill Name
## Overview
Describe the skill's purpose and applicable scenarios.
## Execution Steps
1. First operation
2. Second operation
## Notes
- Note 1
- Note 2For detailed format specifications, see Digital Employee Skill Format Specification.
Step 4: Save and Verify
After adding the skill, complete its creation.
On the conversation interface, enter relevant questions to verify if the skill triggers correctly.