{"id":49038873,"url":"https://github.com/Cadasto/openehr-assistant-plugin","last_synced_at":"2026-05-05T19:00:54.868Z","repository":{"id":343494353,"uuid":"1177762562","full_name":"Cadasto/openehr-assistant-plugin","owner":"Cadasto","description":"openEHR assistant AI plugin suite with Skills, commands, and MCP server configuration for clinical workflow integration","archived":false,"fork":false,"pushed_at":"2026-04-21T20:25:54.000Z","size":318,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-21T22:30:17.926Z","etag":null,"topics":["claude-code-plugin","claude-skills","cursor-rules","openehr","skills"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cadasto.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-10T10:49:55.000Z","updated_at":"2026-04-21T20:26:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Cadasto/openehr-assistant-plugin","commit_stats":null,"previous_names":["cadasto/openehr-assistant-plugin"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Cadasto/openehr-assistant-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cadasto%2Fopenehr-assistant-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cadasto%2Fopenehr-assistant-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cadasto%2Fopenehr-assistant-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cadasto%2Fopenehr-assistant-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cadasto","download_url":"https://codeload.github.com/Cadasto/openehr-assistant-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cadasto%2Fopenehr-assistant-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32663438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code-plugin","claude-skills","cursor-rules","openehr","skills"],"created_at":"2026-04-19T14:00:39.441Z","updated_at":"2026-05-05T19:00:54.858Z","avatar_url":"https://github.com/Cadasto.png","language":"Shell","funding_links":[],"categories":["Clinical Skills \u0026 Knowledge Bases"],"sub_categories":[],"readme":"# openEHR Assistant Plugin\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/version-0.6.0-blue)](CHANGELOG.md)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-plugin-D97757?logo=anthropic\u0026logoColor=white)](https://claude.ai/code)\n[![Cursor](https://img.shields.io/badge/Cursor-plugin-000?logo=cursor\u0026logoColor=white)](https://cursor.com)\n[![openehr-assistant-mcp](https://img.shields.io/badge/openehr--assistant--mcp-v0.16.0-brightgreen)](https://github.com/Cadasto/openehr-assistant-mcp)\n[![openEHR](https://img.shields.io/badge/openEHR-compatible-009688)](https://openehr.org)\n[![Keep a Changelog](https://img.shields.io/badge/Keep%20a%20Changelog-1.1.0-E05735)](CHANGELOG.md)\n\nAI 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.\n\nThis 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.\n\n**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).\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Setup (MCP server)](#setup-mcp-server)\n- [Components](#components)\n- [Companion MCP Server](#companion-mcp-server)\n- [License](#license)\n\n---\n\n## Features\n\n- **Guide-first workflows** — Skills and commands instruct the assistant to load relevant implementation guides from the MCP server before answering.\n- **Archetype authoring** — Create, edit, extend, and specialize clinical archetypes with lint rules and idiom lookup.\n- **Template design** — Build and constrain templates using the CGEM framework and narrowing principle.\n- **Composition building** — Generate FLAT, STRUCTURED, and CANONICAL format instances.\n- **AQL queries** — Write, explain, and optimize Archetype Query Language queries.\n- **CKM discovery** — Search the Clinical Knowledge Manager for archetypes and templates.\n- **Demographic modeling** — PARTY hierarchy, roles, relationships, identity patterns.\n- **Offline reference** — Quick-reference, ADL/AQL syntax cheatsheets, and RM type reference in the repo when MCP is unavailable.\n\n---\n\n## Installation\n\n**Claude Code**\n\n```bash\nclaude plugin add cadasto/openehr-assistant-plugin\n```\n\n**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.\n\n**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).\n\n---\n\n## Setup (MCP server)\n\nThis 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.\n\nFor **server installation, transports (streamable-http vs stdio), and client-specific configuration** (Claude Desktop, Cursor, LibreChat, Junie), see:\n\n- **[openehr-assistant-mcp — Quick Start](https://github.com/Cadasto/openehr-assistant-mcp#quick-start)** (hosted, Docker, stdio)\n- **[openehr-assistant-mcp — Common client configurations](https://github.com/Cadasto/openehr-assistant-mcp#common-client-configurations)**\n\nEnvironment 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).\n\n---\n\n## Components\n\n### Skills\n\n| Skill | Trigger | Description |\n|-------|---------|-------------|\n| `archetype-authoring` | Creating/editing archetypes | Multi-step archetype authoring with guide-first approach |\n| `archetype-lint` | Reviewing/validating archetypes | 22 normative lint rules with STRICT/PERMISSIVE modes |\n| `template-authoring` | Creating/reviewing templates | Template design with CGEM framework and narrowing principle |\n| `composition-builder` | Building compositions | FLAT/STRUCTURED/CANONICAL format generation |\n| `aql-query` | Writing AQL queries | Query authoring with optimization guidance |\n| `demographic-modeling` | Designing demographic models | PARTY hierarchy, roles, relationships, identity patterns |\n| `openehr-assistant` | Any openEHR mention | Clinical modeling and tool routing |\n\n### Commands\n\n| Command | Description |\n|---------|-------------|\n| `/archetype-search \u003cquery\u003e` | Find archetypes in CKM |\n| `/archetype-explain \u003cid\u003e` | Explain archetype semantics and structure |\n| `/archetype-lint \u003cfile or id\u003e [strict]` | Lint archetype against 22 normative rules |\n| `/archetype-review \u003cfile or id\u003e [strict]` | Multi-stage review pipeline (intent, lint, fix, re-lint, review packet) |\n| `/template-search \u003cquery\u003e` | Find templates in CKM |\n| `/template-explain \u003cid\u003e` | Explain template semantics and structure |\n| `/aql-designer \u003cquestion or query\u003e` | Explain, design, or review AQL queries |\n| `/format-data \u003ctemplate or question\u003e` | Explain or design openEHR data instances (FLAT/STRUCTURED/CANONICAL) based on a template |\n| `/rm-structure \u003cdomain\u003e \u003cconcept\u003e` | Explain RM structural concepts in a given domain (`ehr` or `demographic`) — composition categories, ISM states, time, versioning, PARTY hierarchy, identities, privacy |\n| `/guide \u003ctopic\u003e` | Browse openEHR implementation guides |\n| `/terminology \u003ccode or term\u003e` | Resolve terminology IDs and rubrics |\n| `/type-spec \u003ctype name\u003e` | Look up RM/AM/BASE type specifications |\n| `/adl-idiom \u003cpattern\u003e` | Quick ADL constraint pattern lookup |\n| `/archetype-fix-syntax \u003cfile\u003e` | Fix ADL syntax errors preserving semantics |\n| `/archetype-translate \u003cfile\u003e \u003clang\u003e` | Add/translate archetype language entries |\n| `/archetype-rationale \u003cfile or id\u003e [--section]` | Generate CKM-quality rationale prose (description, purpose, misuse, use) |\n| `/template-from-form \u003cform text or path\u003e` | Map a clinical form to a template sketch (archetypes + narrowing) |\n| `/archetype-impact \u003carchetype-id\u003e` | Scan workspace for all references to an archetype (templates, AQL) |\n| `/archetype-diff \u003cfile-a\u003e \u003cfile-b\u003e` | Semantic diff between two archetypes; version-bump classification |\n| `/template-diff \u003cfile-a\u003e \u003cfile-b\u003e` | Semantic diff between two templates; version-bump classification |\n\n### Agents\n\n| Agent | Description |\n|-------|-------------|\n| `clinical-modeler` | Local clinical model file analyst for reading, writing, reviewing, and editing archetype/template files in the workspace |\n| `ckm-scout` | CKM reuse-search specialist — parallel searches, ranked recommendation |\n| `spec-researcher` | Spec research specialist using llms.txt/.md twin methodology |\n\n---\n\n## Companion MCP Server\n\nThe [openehr-assistant-mcp](https://github.com/Cadasto/openehr-assistant-mcp) server provides:\n\n- 12 MCP tools (CKM search, guide access, terminology, type specs, ADL idioms, curated examples)\n- 15 MCP prompts (guided clinical workflows)\n- Implementation guides across six categories: `archetypes/`, `templates/`, `aql/`, `simplified_formats/`, `specs/` (openEHR specification digests tracking the `development` branch), and `howto/` (toolchain how-tos)\n- Curated worked examples at `openehr://examples/{kind}/{name}` — AQL, FLAT, STRUCTURED payloads, and CKM-published reference `.adl` archetypes\n\n**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.\n\nOffline 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.\n\nSee [CHANGELOG.md](CHANGELOG.md) for release notes.\n\n---\n\n## License\n\n[MIT License](LICENSE) — Cadasto B.V.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCadasto%2Fopenehr-assistant-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCadasto%2Fopenehr-assistant-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCadasto%2Fopenehr-assistant-plugin/lists"}