Skill and Rule Management Center

You can manage your skills and rules on the Skills & Rules page, such as creating, editing, enabling, and deleting skills and rules. The skills and rules can be synchronized and used on the CodeArts Agent client.

CodeArts Agent allows you to create local and cloud skills and rules. Local skills and rules are created on the client, while cloud skills and rules are created on the console. Note that cloud user rules can be created either on the console or on the local client.

This section describes how enterprise members manage cloud skills and rules on the console. For details about how to manage skills and rules on the client, see Skills and Rules.

Skill Directory Structure

A skill is a folder with a necessary SKILL.md file and optional resources. It bundles the knowledge and tools needed to perform particular tasks.

skill-name/
├── SKILL.md (Required)
│   ├── YAML frontmatter metadata (Required)
│   │   ├── name: (Required)
│   │   └── description: (Required)
│   └── Markdown instructions (Required)
└── Bundled Resources/ (Optional)
    ├── scripts/      - Executable code (Python, Bash, etc.)
    ├── references/   - Documents to be loaded into the context
    └── assets/       - Files used in the output (templates, icons, fonts, etc.)

**Table 1** Skill parameters
Parameter	Description
skill-name	Serves as the root directory for the entire skill. Replace skill-name with your specific skill's name, such as data-analysis-skill. The skill name consists of lowercase letters, digits, and hyphens (-). It cannot start or end with a hyphen, cannot contain consecutive hyphens, and must be 1 to 64 characters in length.
SKILL.md	Serves as the core description file of a skill. Its name cannot be modified. It includes the following essential sections: YAML frontmatter metadata: Placed at the very top of the SKILL.md file and enclosed by --- at the beginning and end, this section provides structured information readable by AI. It contains two fields: name and description. name: The skill name consists of lowercase letters, digits, and hyphens (-). It cannot start or end with a hyphen, cannot contain consecutive hyphens, and must be 1 to 64 characters in length. The value of name must be the same as that of skill-name. description: The skill description contains a maximum of 1,024 characters. This field is critical for CodeArts Agent to recognize the skill's usage scenarios, and must clearly describe the skill functions and trigger conditions. Markdown instructions: The Markdown content below the YAML metadata, used to detail the usage methods, parameters, examples, and dependencies of the skill.
Bundled Resources (optional)	Holds files needed for the skill. While not mandatory, it enhances the skill's functionality. scripts/: contains executable files like Python and shell scripts that perform specific tasks for the skill. references/: holds essential documents like APIs, domain knowledge, and company policies that support agent skills. It acts as the agent's knowledge base. Documents are loaded into the context when needed for skill execution. assets/: contains resource files like fonts, company logos, and PowerPoint templates. The agent uses these files directly in its output without loading them into the context window.

Cloud Skill and Rule Types

**Table 2** Cloud skill and rule types
Scope	Applicable To	Description
Enterprise	All enterprise members	Skills and rules available throughout the enterprise, available to all members, created by the enterprise administrator, and stored in the cloud.
Team	All members of a specified team	Skills and rules available to entire teams, available to specific teams, created by the enterprise administrator or team administrator, and stored in the cloud.
User	Self only	Available only to a specific user and stored in the cloud.

Constraints

Only the basic and professional packages support the creation of cloud skills and rules.
If there are skills or rules with the same name, the invocation priority is as follows:
- Skills: cloud enterprise skills > cloud team skills > local project skills > local user skills > cloud user skills > built-in system skills.
- Rules: cloud enterprise rules > cloud team rules > local project rules > local user rules > cloud user rules.

Creating a Cloud Skill

Log in to the CodeArts Agent console as an enterprise member or administrator.
In the navigation pane on the left, choose Agent Settings > Skills and Rules. The skill and rule lists are displayed.
On the Skills tab, click Add Skill in the upper right corner. The Add Skill dialog box is displayed.
Click in the blue box area and upload the target skill ZIP file from your local machine. Alternatively, drag and drop the local skill ZIP file to the blue box area and click OK.
- The skill ZIP file must conform to the required directory structure; otherwise, the import may fail. For example, the root directory of each skill folder must contain a SKILL.md file, which must include the skill name, description, and other details in YAML format.
- Only one ZIP file can be uploaded at a time. The file can contain multiple skill folders, and the total file size cannot exceed 5 MB.
Figure 1 Creating a skill

Set parameters for creating a cloud skill as instructed in Table 3.

Figure 2 Creating a cloud skill
Click to enlarge

**Table 3** Cloud skill parameters
Parameter	Description
Change	If you need to re-upload a skill ZIP file, click Change and re-upload it as instructed in 4.
Applied To	Private: available only to yourself and will not be shared with other users. Team: available to specified teams and can be created by enterprise administrators or team administrators. Enterprise: available to all members of the entire enterprise, and can only be created by enterprise administrators.
Teams	This parameter is displayed only when Applied To is set to Team. Select a team from the drop-down list. If no team has been created, create one first. Enterprise administrators can view and select all teams, while team administrators can only view and select the team they belong to.
Tag	(Optional) Several types of tags have been preset in CodeArts Agent. Select tags from the drop-down list as required.

Click Confirm and Enable to complete the skill creation.

On the Skills tab, view the created skill. To immediately view the created cloud skill on the client, go to the corresponding skill tab (Enterprise/Team/User) under Skills and Rules on the settings page of the client, and click or choose > Update in the skills area. Then the cloud skill is synchronized to the client.
- The client automatically synchronizes cloud skills every 24 hours.
- The client synchronizes only enabled skills.

Managing Cloud Skills

Table 4 shows the operation permissions of different roles on managing cloud skills.

**Table 4** Operation permissions of different roles on cloud skills
Role	Enterprise Skill	Team Skill	User Skill
Enterprise administrator	All operations on all skills.	All operations on all skills.	All operations except editing on all skills. They can edit only the skills created by themselves.
Team administrator	The following operations can be performed: View cloud skill details. Favorite or unfavorite skills.	All operations on skills created by members of their own team (including the team administrators).	All operations on the skills created by themselves.
Team member	The following operations can be performed: View cloud skill details. Favorite or unfavorite skills.	The following operations can be performed on skills created by members of their own team: View cloud skill details. Favorite or unfavorite skills.	All operations on the skills created by themselves.
Enterprise member	The following operations can be performed: View cloud skill details. Favorite or unfavorite skills.	No operation permissions.	All operations on the skills created by themselves.

**Table 5** Managing cloud skills
Operation	Procedure
Viewing cloud skill details	On the console, choose Skills & Rules, click the Skills tab, and then click the name of the target skill to view its details. On the settings page of the client, choose Skills and Rules. Go to the corresponding skill tab (Enterprise/Team/User). Hover the cursor on the target skill and click to view the skill details.
Editing cloud skills	On the console, choose Skills & Rules, click the Skills tab, and view the status of the target skill. If it is enabled, disable it first. If it is disabled, go to the next step to edit the skill. Click Edit next to the target skill.
Deleting a cloud skill	On the console, choose Skills & Rules, click the Skills tab, and view the status of the target skill. If it is enabled, disable it first. If it is disabled, go to the next step to delete the skill. Click Delete next to the target skill. The target skill is successfully deleted when it is removed from the skill list. CAUTION: Deleting a skill will affect the agents using it. Deleted skills cannot be recovered. Exercise caution when performing this operation.
Enabling or disabling a cloud skill	Use either of the following methods to enable or disable a cloud skill: On the console, choose Skills & Rules, click the Skills tab, and click / next to the target skill. Only enabled skills can be synchronized to the CodeArts Agent client. On the settings page of the client, choose Skills and Rules. Go to the corresponding skill tab (Enterprise/Team/User). Toggle a target skill on or off.
Adding a cloud skill to favorites or removing it	On the console, choose Skills & Rules, click the Skills tab, and click Favorite or Unfavorite next to the target skill. View the favorites on the Favorites tab.
Batch deleting cloud skills	On the console, choose Skills & Rules, click the Skills tab, and view the status of the target skill. If it is enabled, disable it first. If it is disabled, go to the next step to delete the skill. Select the target skills and choose More > Batch Delete in the upper right corner. A confirmation dialog box is displayed. Enter DELETE or click Autofill, and then click OK. The target skill is successfully deleted when it is removed from the skill list.
Batch enabling or disabling cloud skills	Use either of the following methods to batch enable or disable cloud skills: On the console, choose Skills & Rules, and click the Skills tab. Select the target skills and click Batch Enable or choose More > Batch Disable in the upper right corner. Only enabled skills can be synchronized to the CodeArts Agent client. On the settings page of the client, choose Skills and Rules. Go to the corresponding skill tab (Enterprise/Team). Click in the upper right corner. Select the target skills and click Enable or Disable in the upper right corner. On the settings page of the client, choose Settings > Skills and Rules > User. Choose > Batch Operate in the upper right corner. Select the target skills and click Enable or Disable in the upper right corner.
Batch adding cloud skills to favorites or removing them	On the console, choose Skills & Rules, and click the Skills tab. Select the target skills and choose More > Batch Favorite or More > Batch Unfavorite in the upper right corner. View the favorites on the Favorites tab.

Creating a Cloud Rule

Log in to the CodeArts Agent console as an enterprise member or administrator.
In the navigation pane on the left, choose Agent Settings > Skills and Rules. The skill and rule lists are displayed.
On the Rules tab, click Add Rule in the upper right corner. The Add Rule dialog box is displayed.

Set the parameters based on Table 6.

Figure 3 Creating a cloud rule
Click to enlarge

**Table 6** Cloud rule parameters
Parameter	Description
Name	Name of the rule to be created. Naming rules: Enter 1 to 64 characters. Only letters, digits, underscores (_), hyphens (-), and periods (.) are allowed.
Content	Customize one or more rules. The value can contain a maximum of 50,000 characters. Example: requiring the system to always respond using Python.
Application Scope	Application scope of a rule, that is, where the rule takes effect. Auto Apply: The rule applies to all chats by default and is automatically identified by the system. Manual Call: The rule does not take effect automatically. To use the rule, on the chat panel, enter # in the input box or click and choose Add Context. Then click Rules and select a rule from the list.
Applied To	Private: available only to enterprise members themselves. Team: available to all members in a specified team, and can be created by enterprise administrators or team administrators. Enterprise: available to all members of the entire enterprise, and can only be created by enterprise administrators.
Teams	This parameter is displayed only when Applied To is set to Team. Select a team from the drop-down list. If no team has been created, create one first. Enterprise administrators can view and select all teams, while team administrators can only view and select the team they belong to.
Label	(Optional) Several types of tags have been preset in CodeArts Agent. Select tags from the drop-down list as required.
Brief Description	(Optional) Description of the rule. Enter up to 1,024 characters.

Click Confirm and Enable to complete the rule creation.

On the Rules tab, view the created rule. To immediately view the created cloud rule on the client, go to the corresponding rule tab (Enterprise/Team/User) under Skills and Rules on the settings page of the client, and click in the rules area. Then the cloud rule is synchronized to the client.
- The client automatically synchronizes cloud rules every 24 hours.
- The client synchronizes only enabled rules.

Managing Cloud Rules

Table 7 shows the operation permissions of different roles on managing cloud rules.

**Table 7** Operation permissions of different roles on cloud rules
Role	Enterprise Rule	Team Rule	User Rule
Enterprise administrator	All operations on all rules.	All operations on all rules.	All operations except editing on all rules. They can edit only the rules created by themselves.
Team administrator	The following operations on all rules: View cloud rule details. Favorite or unfavorite rules.	All operations on rules created by members of their own team (including the team administrators).	All operations on the rules created by themselves.
Team member	All operations on all rules. View cloud rule details. Favorite or unfavorite rules.	The following operations can be performed on rules created by members of their own team (including the team administrator): View cloud rule details. Favorite or unfavorite rules.	All operations on the rules created by themselves.
Enterprise member	All operations on all rules. View cloud rule details. Favorite or unfavorite rules.	No operation permissions.	All operations on the rules created by themselves.

**Table 8** Managing cloud rules
Operation	Procedure
Viewing cloud rule details	On the console, choose Skills & Rules, click the Rules tab, and then click the name of the target rule to view its details. On the settings page of the client, choose Skills and Rules. Go to the corresponding rule tab (Enterprise/Team/User). Hover the cursor on the target rule and click to view the rule details.
Editing a cloud rule	On the console, choose Skills & Rules, click the Rules tab, and view the status of the target rule. If it is enabled, disable it first. If it is disabled, go to the next step to edit the rule. Click Edit next to the target rule.
Deleting a cloud rule	On the console, choose Skills & Rules, click the Rules tab, and view the status of the target rule. If it is enabled, disable it first. If it is disabled, go to the next step to delete the rule. Click Delete next to the target rule. The target rule disappears from the list once successfully deleted. CAUTION: Deleting a rule will affect the agents using it. Deleted rules cannot be recovered. Exercise caution when performing this operation.
Enabling or disabling a cloud rule	On the console, choose Skills & Rules, click the Rules tab, and click / next to the target rule. Only enabled rules can be synchronized to the client.
Adding a cloud rule to favorites or removing it	On the console, choose Skills & Rules, click the Rules tab, and click Favorite or Unfavorite next to the target rule. View the favorites on the Favorites tab.
Batch deleting cloud rules	On the console, choose Skills & Rules, click the Rules tab, and view the status of the target rule. If it is enabled, disable it first. If it is disabled, go to the next step to delete the rule. Select the target rules and choose More > Batch Delete in the upper right corner. A confirmation dialog box is displayed. Enter DELETE or click Autofill, and then click OK. The target rule disappears from the list once successfully deleted. CAUTION: Deleting a rule will affect the agents using it. Deleted rules cannot be recovered. Exercise caution when performing this operation.
Batch enabling or disabling cloud rules	On the console, choose Skills & Rules, and click the Rules tab. Select the target rules and click Batch Enable or choose More > Batch Disable in the upper right corner. Only enabled rules can be synchronized to the client.
Batch adding cloud rules to favorites or removing them	On the console, choose Skills & Rules, and click the Rules tab. Select the target rules and choose More > Batch Favorite or More > Batch Unfavorite in the upper right corner. View the favorites on the Favorites tab.
Modifying the application scope of cloud enterprise rules or team rules	On the settings page of CodeArts Agent IDE, choose Skills and Rules > Enterprise > Rules or Skills and Rules > Team > Rules. Locate the target rule and click the switch next to it. : You need to manually apply the rule. : The system automatically identifies the rule and applies it.
Batch modifying the application scope of cloud enterprise rules or team rules	On the settings page of CodeArts Agent IDE, choose Skills and Rules > Enterprise > Rules or Skills and Rules > Team > Rules. Click in the upper right corner. Select the target rules and click Enable or Disable in the upper right corner.