Skip to main content

Create and Publish a Skill

There are three ways to add a skill: author it manually, upload an existing skill file, or import from a GitHub repository. Open Build > Skills to start.

Prerequisites​

You need:

  • admin access to Willow
  • for GitHub import: a repository whose root contains a skills/ folder

Create a skill manually​

  1. Open Build > Skills.
  2. Select Add Skill, then Manual.
  3. Fill in the Create Skill form:
    • Name: display name of the skill.
    • Slug: URL-safe identifier, auto-generated from the name.
    • Description: what the skill does and when the agent should use it.
    • Content: the skill body in Markdown.
  4. Select Create Skill to save it as a draft, or Create & Publish to save and publish in one step.
Create Skill form with Name, Slug, Description, and a Markdown content field, plus Create Skill and Create & Publish actions

Upload a skill file​

  1. Select Add Skill, then Upload .md / .zip / .skill.
  2. Choose the file to upload:
    • .md for a single-file skill.
    • .zip or .skill for a skill that includes scripts, references, or assets.
  3. Willow imports the skill and opens it for review.

Import skills from GitHub​

  1. Select Add Skill, then From GitHub.
  2. Enter the repository in owner/repo format.
  3. Willow imports every skill it finds. The repository should contain a skills/ folder at its root, with each subfolder holding one skill and a SKILL.md file.
Import skills from GitHub dialog with a repository field using the owner/repo placeholder

To keep imported skills in sync over time, configure a source repository in Skills Settings.

Publish a skill​

A skill created manually (without Create & Publish) or imported starts as a draft. To make it available:

  1. From the Skills list, open the ... menu on the skill row.
  2. Select Publish. The status changes to active.

To let people use the skill, assign it to a group. To distribute it through your marketplace, bundle it into a plugin.

What to do next​

On this page