Skip to content
Skiller Skiller

Introduction

Skiller runs skills: declarative, multi-step workflows you define in YAML and Markdown and launch from the @skiller chat participant. Each skill is a playbook — a sequence of typed steps that call a language model, invoke your MCP tools, and pause for your input or approval exactly where you tell them to.

If you have read the home page, you have the pitch: Skiller is the deliberate opposite of a free-form agent. This page shows you what a skill actually looks like and how the @skiller participant behaves, then points you at installation.

What a skill looks like

Section titled “What a skill looks like”

A skill is a folder with a skill.yaml manifest and one Markdown file per model prompt:

.skiller/skills/greeter/
├── skill.yaml          # inputs, steps, and wiring
└── steps/
    ├── 01-greet.md     # a Liquid-templated prompt
    └── 02-fact.md

The manifest is small and readable. Here is the start of the built-in greeter skill — an input, an llm step that drafts a greeting, and a confirmation step that pauses for your choice (abridged; you will build the full version on the next pages):

id: greeter
name: Greeter
description: A simple greeting workflow demonstrating multi-step skills with confirmation


inputs:
  - name: name
    type: string
    description: Your name
    required: true
    prompt: "What is your name?"


steps:
  - id: greet
    type: llm
    file: steps/01-greet.md
    output: greeting


  - id: confirm
    type: confirmation
    message: |
      {{ outputs.greeting }}


      Would you like me to also generate a fun fact?
    options:
      - { label: "Yes, give me a fun fact",      action: continue }
      - { label: "No thanks, just the greeting", action: abort }
    output: user_choice

The {{ outputs.greeting }} reference is Liquid templating: each step can read the output of an earlier one. Steps run in order, the model fills in the llm steps, and the confirmation step stops to wait for you.

What to expect from @skiller

Section titled “What to expect from @skiller”

@skiller is a skills runner, not a general-purpose chat assistant. It responds to two kinds of messages:

  • Slash commands — /skills, /skill <id>, /help, and the rest (see the full Commands reference).
  • A skill launch — @skiller /skill greeter runs the greeter skill end to end.

Any other message — a free-form question or instruction — returns a short hint pointing you back at the commands. Skiller does not improvise its own steps or hold an open-ended conversation; that predictability is the point.

Next steps

Section titled “Next steps”