Skip to main content

Editing Skills

Modify existing skills to update their content and resources.

Opening the Editor​

Click on a skill card to open the skill editor.

Editable Fields​

Skill Name​

Update the display name of your skill.

Slug​

The slug is shown but typically cannot be changed after creation.

Description​

Update the description of what the skill does. This is what agents see when discovering your skill.

Content (Markdown)​

Edit the main instructions for the skill. The preview panel on the right updates in real-time as you type.

Skill Resources​

Below the main content editor, there are three tabs for managing skill resources. These correspond to the optional directories in the Agent Skills specification:

Scripts​

Add executable code that agents can run as part of the skill.

Scripts should:

  • Be self-contained or clearly document dependencies
  • Include helpful error messages
  • Handle edge cases gracefully

Supported languages depend on the agent implementation. Common options include Python, Bash, and JavaScript.

References​

Additional documentation that agents can read when needed.

  • Click Create Reference to add a new reference document
  • Keep individual reference files focused
  • Agents load these on demand, so smaller files mean less context usage

Good uses for references:

  • Detailed technical specifications
  • Form templates or structured data formats
  • Domain-specific documentation

Assets​

Upload static resources for the skill to use:

  • Template files (document templates, configuration templates)
  • Images (diagrams, examples)
  • Data files (lookup tables, schemas)

Saving Changes​

Click the Save button to save your changes.