Skip to main content

User skills and slash recipes

Skills are markdown recipes your app (or end users) can apply during a chat.

App-declared skills (YAML)​

app.yaml
dev:
  skills:
    - command: /commit
      description: "Stage + commit + push the current diff"
      path: skills/commit.md

Put the body in skills/commit.md next to app.yaml. Users invoke /commit from the composer; the agent also has use_skill when that meta-tool is available.

See Skills and Bundle namespaces.

Let users create their own skills​

Opt in from YAML:

app.yaml
dev:
  allow_user_skills: true
  skills:
    - command: /commit
      description: "Stage + commit + push the current diff"
      path: skills/commit.md

When allow_user_skills is true, the Digitorn UI can show a "+ New skill" affordance. User skills are per user and app; a user skill with the same name shadows the app-declared one.

When false (default), only skills declared in the YAML bundle are available.

How /use_skill behaves​

  1. The user picks a skill (or types /use_skill name …).
  2. For that turn, Digitorn injects the skill body as a system directive the agent must follow.
  3. Later turns do not keep that directive unless the user invokes the skill again.