@rcrsr/rill-ext-prompt-md

rill extension that loads .prompt.md files from a directory tree and exposes each file as a typed callable. Prompts carry typed params, interpolation placeholders, and optional @@ role sections that produce a message list ready for any LLM extension's messages() call.

Install

npm install @rcrsr/rill-ext-prompt-md

Quick Start

prompts/summarize.prompt.md

---
description: Summarize a passage in a bounded word count.
params:
  - "passage: string"
  - "max_words: number = 200"
---
Summarize the following passage in {max_words} words or fewer.

{passage}

The output mode is inferred from body content. Bodies that contain @@ role markers return list(dict(role: string, content: string)); everything else returns a plain string.

rill-config.json

{
  "main": "app.rill",
  "extensions": {
    "mounts": {
      "prompt": "@rcrsr/rill-ext-prompt-md"
    },
    "config": {
      "prompt": {
        "basePath": "./prompts"
      }
    }
  }
}

app.rill

use<ext:prompt> => $prompt

$prompt.summarize("Long passage here...") -> log

rill-run

Documentation

See full documentation for file format, frontmatter grammar, @@ role convention, interpolation rules, closure annotations, and a runnable LLM round-trip example.

Nested type expressions like list(dict(title: string, body: string)) are supported in param declarations. See the Params Grammar section in the full docs for the complete type syntax.

License

MIT