An App Skills extension is a single configuration file. You generate the file first, then write the skills in it.
This article walks through generating the file and writing a skill that guides Aria through a refund request.
Follow the instructions below to:
Start from a generated App Skills extension rather than an empty folder, so the file structure and registration are already in place.
For the full procedure, see Add an App Skills Extension in Studio Two.
This step gives you a generated App Skills extension in your site.
You can find the new file under src/extensions/backend/app-skills/<extension-name>/. You spend most of this article in <extension-name>.extension.ts. For what's in the file, see App Skills Extension Files and Code.
<extension-name>.extension.ts is the configuration file. It uses the extensions.appSkills() builder:
The id and name uniquely identify the extension.
skills is the array of skill declarations, which you configure in step 3.
Each object in the skills array declares 1 skill. To declare a skill:
skills array with a slug, description, and guidelines.activated to true. A skill with activated set to true must have guidelinesFor example, to declare a skill that guides Aria through a refund request, open <extension-name>.extension.ts and add the object below.
With 1 skill in the array, the file looks like this:
Aria decides whether a skill fits a request from its examples, tags, and description, so write them the way a Wix user would phrase the request.
For every field and its limits, see App Skills Extension Files and Code. If your site can't publish after you change the file, see Common errors.
When you're happy with the skill, click Publish in the Studio Two editor to ship it with your site. Aria can use your skills only after you publish.
To check that Aria uses the skill, see Add an App Skills Extension in Studio Two.
Last updated: 2 November 2026