Create, Import, and Manage Skills

Custom Skills let you package your own instructions for repeated use. Import is useful when a compatible Skill already exists and you want to review it before adding it to Runner.

What this covers

You will know how to create or import a Skill, understand each editor control, and distinguish reversible pause from permanent deletion.

Availability and prerequisites

• Open a project with access to Agent → Skills.
• Skills require plan access.
• Import requires a compatible source URL that Runner can read.
• Do not import instructions you do not trust. Review the name, description, content, settings, and included files before saving.

Entry paths

• Create: Control Center → Agent → Skills → Discover → Create Skill
• Import: Control Center → Agent → Skills → Discover → Import
• Edit or delete: Control Center → Agent → Skills → Added → More actions

Skill editor controls

Create a custom Skill

1. Open Agent → Skills.
2. In Discover, select Create Skill.
3. Enter a valid Name, a concise Description, and the Skill Content. These fields are required.
4. Add a category, shortcut label, argument hint, or supporting files only when they make the Skill easier to use.
5. Review Enabled, Disable AI Auto-Invocation, and User Invocable. These controls change how Runner can use the Skill.
6. Select the save/create action.
7. Confirm the Skill appears under Added or Paused, depending on the Enabled setting.

Import a Skill

1. In Agent → Skills → Discover, select Import.
2. Paste the compatible source URL.
3. Select Import.
4. For one discovered Skill, Runner opens the editor with imported fields filled in. For a source containing several Skills, Runner opens a chooser.
5. Review every imported field and any excluded-file or size warning.
6. Make necessary changes, then save.
7. Confirm the Skill appears in the Agent page before closing your workflow.

Import does not make unreviewed content trustworthy. Treat imported instructions like any other content that can influence Runner's work.

Edit, pause, or delete

1. Select a Custom Skill row or open More actions → Edit.
2. Change the fields you need and save.
3. To stop using it without losing it, select Added to move it to Paused.
4. To remove it, open More actions → Delete.
5. Review the named confirmation dialog and select Delete only when you intend to remove the Skill.

Delete is destructive. It is not the same as pausing, and the page does not present it as an undoable action. System Skills do not offer delete.

States and limits

• Missing Name, Description, or Content blocks saving and shows a validation message.
• A duplicate imported Skill name can be rejected or marked as already present.
• Files that exceed accepted limits can be skipped; a total-size warning can block saving until content is reduced.
• While save, import, or delete is running, wait for the success or error message before taking another action.
• View-only System Skills can show details but do not expose Custom Skill editing controls.

Troubleshooting

• If Import stays unavailable, wait for the existing-Skill check to finish and confirm the URL field is not empty.
• If import opens a batch chooser, select only the Skills you recognize and need.
• If save is blocked, check the required fields and any file warning at the top of the editor.
• If a Skill disappeared after selecting Added, check Paused before recreating it.
• If deletion fails, the Skill remains; close the error and retry after checking your permissions.

Related guides

• Skills
• Agent Customization overview
• Use the Agent command palette
• Store Agent settings