https://github.com/Cadasto/openehr-assistant-plugin
openEHR assistant AI plugin suite with Skills, commands, and MCP server configuration for clinical workflow integration
https://github.com/Cadasto/openehr-assistant-plugin
claude-code-plugin claude-skills cursor-rules openehr skills
Last synced: about 2 months ago
JSON representation
openEHR assistant AI plugin suite with Skills, commands, and MCP server configuration for clinical workflow integration
- Host: GitHub
- URL: https://github.com/Cadasto/openehr-assistant-plugin
- Owner: Cadasto
- License: mit
- Created: 2026-03-10T10:49:55.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-21T20:25:54.000Z (2 months ago)
- Last Synced: 2026-04-21T22:30:17.926Z (2 months ago)
- Topics: claude-code-plugin, claude-skills, cursor-rules, openehr, skills
- Language: Shell
- Homepage:
- Size: 311 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-medical-ai-skills - openEHR Assistant Plugin - assistant-plugin?style=flat-square) | AI plugin suite for openEHR clinical-workflow integration. Adds guide-first skills and commands for CKM discovery, archetype/template authoring, composition building, and AQL workflows; pairs with a companion MCP server. | (Clinical Skills & Knowledge Bases)
README
# openEHR Assistant Plugin
[](LICENSE)
[](CHANGELOG.md)
[](https://claude.ai/code)
[](https://cursor.com)
[](https://github.com/Cadasto/openehr-assistant-mcp)
[](https://openehr.org)
[](CHANGELOG.md)
AI plugin suite for clinical workflow integration with [openEHR](https://openehr.org/) systems. Adds skills, commands, agents, and hooks for **[Claude Code](https://claude.ai/code)** and **[Cursor](https://cursor.com)** that guide AI assistants through openEHR modeling, CKM discovery, and specification lookups.
This plugin works with the [openEHR Assistant MCP Server](https://github.com/Cadasto/openehr-assistant-mcp), which provides the tools, prompts, and resources (CKM, guides, terminology, type specs). The plugin supplies the workflow layer: when to load which guides, which commands to offer, and how to stay aligned with openEHR best practices.
**Recommended:** For installation, transports, and MCP client configuration of the server (hosted vs local, streamable-http vs stdio), see the **[openehr-assistant-mcp README](https://github.com/Cadasto/openehr-assistant-mcp#quick-start)** — [Quick Start](https://github.com/Cadasto/openehr-assistant-mcp#quick-start) and [Common client configurations](https://github.com/Cadasto/openehr-assistant-mcp#common-client-configurations).
## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Setup (MCP server)](#setup-mcp-server)
- [Components](#components)
- [Companion MCP Server](#companion-mcp-server)
- [License](#license)
---
## Features
- **Guide-first workflows** — Skills and commands instruct the assistant to load relevant implementation guides from the MCP server before answering.
- **Archetype authoring** — Create, edit, extend, and specialize clinical archetypes with lint rules and idiom lookup.
- **Template design** — Build and constrain templates using the CGEM framework and narrowing principle.
- **Composition building** — Generate FLAT, STRUCTURED, and CANONICAL format instances.
- **AQL queries** — Write, explain, and optimize Archetype Query Language queries.
- **CKM discovery** — Search the Clinical Knowledge Manager for archetypes and templates.
- **Demographic modeling** — PARTY hierarchy, roles, relationships, identity patterns.
- **Offline reference** — Quick-reference, ADL/AQL syntax cheatsheets, and RM type reference in the repo when MCP is unavailable.
---
## Installation
**Claude Code**
```bash
claude plugin add cadasto/openehr-assistant-plugin
```
**Cursor** — Add the plugin via Cursor’s plugin flow (e.g. from a Git URL or local path). The repo includes a Cursor manifest at [`.cursor-plugin/plugin.json`](.cursor-plugin/plugin.json); skills, commands, agents, and MCP config are shared with the Claude plugin.
**Contributors:** See [CONTRIBUTING.md](CONTRIBUTING.md) for maintainer workflows, **clone vs `git archive`** (`.gitattributes` `export-ignore`), and how to bump compatibility with [openehr-assistant-mcp](https://github.com/Cadasto/openehr-assistant-mcp).
---
## Setup (MCP server)
This plugin expects the **openEHR Assistant MCP Server** to be configured in your client. The plugin ships with a default MCP config that points at the hosted server; you can override it for local or stdio use.
For **server installation, transports (streamable-http vs stdio), and client-specific configuration** (Claude Desktop, Cursor, LibreChat, Junie), see:
- **[openehr-assistant-mcp — Quick Start](https://github.com/Cadasto/openehr-assistant-mcp#quick-start)** (hosted, Docker, stdio)
- **[openehr-assistant-mcp — Common client configurations](https://github.com/Cadasto/openehr-assistant-mcp#common-client-configurations)**
Environment variables (e.g. `CKM_API_BASE_URL`) and Docker/stdio details are documented in the [MCP server README](https://github.com/Cadasto/openehr-assistant-mcp).
---
## Components
### Skills
| Skill | Trigger | Description |
|-------|---------|-------------|
| `archetype-authoring` | Creating/editing archetypes | Multi-step archetype authoring with guide-first approach |
| `archetype-lint` | Reviewing/validating archetypes | 22 normative lint rules with STRICT/PERMISSIVE modes |
| `template-authoring` | Creating/reviewing templates | Template design with CGEM framework and narrowing principle |
| `composition-builder` | Building compositions | FLAT/STRUCTURED/CANONICAL format generation |
| `aql-query` | Writing AQL queries | Query authoring with optimization guidance |
| `demographic-modeling` | Designing demographic models | PARTY hierarchy, roles, relationships, identity patterns |
| `openehr-assistant` | Any openEHR mention | Clinical modeling and tool routing |
### Commands
| Command | Description |
|---------|-------------|
| `/archetype-search ` | Find archetypes in CKM |
| `/archetype-explain ` | Explain archetype semantics and structure |
| `/archetype-lint [strict]` | Lint archetype against 22 normative rules |
| `/archetype-review [strict]` | Multi-stage review pipeline (intent, lint, fix, re-lint, review packet) |
| `/template-search ` | Find templates in CKM |
| `/template-explain ` | Explain template semantics and structure |
| `/aql-designer ` | Explain, design, or review AQL queries |
| `/format-data ` | Explain or design openEHR data instances (FLAT/STRUCTURED/CANONICAL) based on a template |
| `/rm-structure ` | Explain RM structural concepts in a given domain (`ehr` or `demographic`) — composition categories, ISM states, time, versioning, PARTY hierarchy, identities, privacy |
| `/guide ` | Browse openEHR implementation guides |
| `/terminology ` | Resolve terminology IDs and rubrics |
| `/type-spec ` | Look up RM/AM/BASE type specifications |
| `/adl-idiom ` | Quick ADL constraint pattern lookup |
| `/archetype-fix-syntax ` | Fix ADL syntax errors preserving semantics |
| `/archetype-translate ` | Add/translate archetype language entries |
| `/archetype-rationale [--section]` | Generate CKM-quality rationale prose (description, purpose, misuse, use) |
| `/template-from-form ` | Map a clinical form to a template sketch (archetypes + narrowing) |
| `/archetype-impact ` | Scan workspace for all references to an archetype (templates, AQL) |
| `/archetype-diff ` | Semantic diff between two archetypes; version-bump classification |
| `/template-diff ` | Semantic diff between two templates; version-bump classification |
### Agents
| Agent | Description |
|-------|-------------|
| `clinical-modeler` | Local clinical model file analyst for reading, writing, reviewing, and editing archetype/template files in the workspace |
| `ckm-scout` | CKM reuse-search specialist — parallel searches, ranked recommendation |
| `spec-researcher` | Spec research specialist using llms.txt/.md twin methodology |
---
## Companion MCP Server
The [openehr-assistant-mcp](https://github.com/Cadasto/openehr-assistant-mcp) server provides:
- 12 MCP tools (CKM search, guide access, terminology, type specs, ADL idioms, curated examples)
- 15 MCP prompts (guided clinical workflows)
- Implementation guides across six categories: `archetypes/`, `templates/`, `aql/`, `simplified_formats/`, `specs/` (openEHR specification digests tracking the `development` branch), and `howto/` (toolchain how-tos)
- Curated worked examples at `openehr://examples/{kind}/{name}` — AQL, FLAT, STRUCTURED payloads, and CKM-published reference `.adl` archetypes
**Compatibility:** This plugin version is built and tested against **openehr-assistant-mcp v0.16.0** ([releases](https://github.com/Cadasto/openehr-assistant-mcp/releases)). When updating the plugin, align with that server’s changelog so each plugin release stays compatible with a specific MCP server version.
Offline reference material in [`skills/openehr-assistant/reference/`](skills/openehr-assistant/reference/) includes a quick-reference (principles, rules, guide index), minimal ADL and AQL syntax cheatsheets, and an RM type reference (~30 commonly archetyped types with attributes for local lint rule 4 validation); see [AGENTS.md](AGENTS.md) (Syntax and grammar sources) for links to official specs and grammars.
See [CHANGELOG.md](CHANGELOG.md) for release notes.
---
## License
[MIT License](LICENSE) — Cadasto B.V.