Dust GitHub Action

A GitHub Action to interact with your Dust workspace.

Methods

upsert-skills

Syncs Agent Skills from the repository to Dust. Finds SKILL.md files, packages their directories into a ZIP, and uploads it.

- uses: dust-tt/dust-github-action@v1
  with:
    method: upsert-skills
    workspace-id: ${{ vars.DUST_WORKSPACE_ID }}
    api-key: ${{ secrets.DUST_API_KEY }}
    region: EU

Method outputs: imported, updated (counts).

Common inputs

Input	Required	Description
method	yes	Action to perform
workspace-id	yes	Dust workspace sId
api-key	yes	Dust API key
region	yes	Workspace region (EU or US)

Common outputs

Output	Description
json	Raw JSON response from the Dust API

Full example

name: Sync Skills to Dust

on:
  push:
    branches: [main]
    paths:
      - "skills/**"
  workflow_dispatch:

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Sync skills
        uses: dust-tt/dust-github-action@v1
        with:
          method: upsert-skills
          workspace-id: ${{ vars.DUST_WORKSPACE_ID }}
          api-key: ${{ secrets.DUST_API_KEY }}
          region: EU

Skill format

Each skill lives in its own directory with a SKILL.md file (spec):

skills/
  review-pr/
    SKILL.md
    template.md       # optional attachment
  summarize/
    SKILL.md

SKILL.md uses YAML frontmatter for metadata and the body as instructions:

---
name: Review PR
description: Reviews pull requests for code quality and correctness
---

You are a code reviewer. When asked to review a PR, analyze the diff for:
- Correctness
- Performance
- Security

Development

npm install
npm run build    # compiles to dist/ via @vercel/ncc
npm run check    # type-check with tsc
npm test         # run tests

dist/ is gitignored and built automatically on release via the publish workflow.