Skip to main content

Creating Skills

Learn how to create custom skills manually, import from files, or use GitHub repositories as skill sources.

Skill Format

Skills are markdown-based knowledge units that get loaded into assistant context on-demand. They support:

  • Markdown content (up to 300KB) - instructions, code examples, best practices
  • Tool references - specify which tools the skill requires
  • No support for: external scripts, file attachments, binary assets, or embedded images

All skill content must be text-based markdown.

Creating a Skill

Supported Format

Markdown files with YAML metadata header.

tip

You can download an example skill file from the Import from File dialog to use as a template.

Download Example Skill File

Template structure:

---
name: example-skill
description: A brief description of what this skill helps with
---

# Example Skill

## Description
This is an example skill that demonstrates the markdown format for importing skills.

## Content
Your skill content goes here. This can include:
- Instructions for the AI assistant
- Code examples
- Best practices
- Any other relevant information

Example:
When the user asks for help with code review, follow these steps:
1. Analyze the code structure
2. Check for common issues
3. Provide constructive feedback

You can use markdown formatting including:
- **Bold text**
- *Italic text*
- Lists
- Code blocks
- Links and more

Import Process

  1. Click Create Skill button
  2. Click Import from File
  3. Click Select file from your local machine
  4. Choose your .md file

Import Skill File Selection

  1. Review auto-populated fields:
    • Description field
    • Instructions field

Import Skill Auto-Populated Form

  1. Adjust if needed
  2. Click Create Skill
tip

The import process automatically parses markdown structure and populates the Description and Instructions fields.

Result

After creating a skill using any method, it will appear in your Project Skills list:

Project Skills List

Click on the skill to view its details page:

Skill Details Page

The created skill can now be:

  • Attached to assistants
  • Edited or exported
  • Published to marketplace
  • Used in chat conversations

Next Steps

After creating skills: