Custom Skill Definition in SuiteCloud Development Framework

TL;DR: In NetSuite 2026.2, the Custom Skill Definition feature simplifies the creation and management of XML-based skill definitions within the SuiteCloud Development Framework. This enhancement streamlines how developers define skills, linking essential XML definitions with their corresponding markdown content.

Overview of Custom Skill Definition

A custom skill in the SuiteCloud Development Framework (SDF) comprises two main components: an agentskill XML definition and a skill content folder containing a SKILL.md file. This combination helps ensure that skills are well-defined and easily deployable within your NetSuite projects.

Key Components

When setting up a custom skill, it is crucial to associate the skill content folder correctly with the XML skillfolder element. The necessary folder and its files must exist prior to validating and deploying the SuiteCloud project. Here’s a breakdown of the essential XML items involved in defining a custom skill:

Skill Content Locations

The skill content folder’s location varies depending on the SuiteCloud project type. Here’s where you can find it based on the project type:

Validation of Skill Definitions

During the deployment of a SuiteCloud project, the custom skill must pass several validation checks:

• Confirm the skillfolder reference points to an existing folder.
• Ensure the folder contains the SKILL.md file.
• Make sure the name and description in the XML definition match their counterparts in the SKILL.md front matter.
• The SKILL.md file must include relevant instructions for the skill.

Example of Skill XML

Here’s an example of an active custom skill defined within a SuiteApp project:

1<agentskill scriptid="customskill_simple_test_skill">
2    <name>simple-test-skill</name>
3    <description>Tiny deterministic test skill for confirming skill discovery and invocation.</description>
4    <skillfolder>[/SuiteApps/com.netsuite.sdfskills/simple-test-skill/]</skillfolder>
5    <isinactive>F</isinactive>
6    <ispublic>F</ispublic>
7</agentskill>

This structure and process ensure that developers can create robust, well-integrated custom skills that function correctly within their NetSuite applications.

Who This Affects

• Developers - Those involved in SuiteCloud Development Framework projects will benefit directly from the feature update.
• Administrators - Admin roles will manage the permissions regarding skill visibility.

Key Takeaways

• Custom skills are now more straightforward to define with XML in SDF projects.
• Validation steps ensure that skills are correctly linked to their content.
• Skill definitions are pivotal in enhancing user interaction with SuiteCloud applications.