Skip to content

Commit 947b717

Browse files
committed
Merge branch 'release/1.3.2'
2 parents da74897 + 660b508 commit 947b717

File tree

10 files changed

+257
-266
lines changed

10 files changed

+257
-266
lines changed

.agents/skills/conch-generator/README.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,24 @@
11
# Agent Skills
22

3-
This directory contains agent skills for AI-powered coding assistants like GitHub Copilot, Claude, and other AI development tools.
3+
This directory contains agent skills for AI-powered coding assistants.
44

5-
## What are Agent Skills?
6-
7-
Agent skills are specialized instructions that help AI coding assistants understand how to work with this repository. They provide context, workflows, and best practices specific to this project.
8-
9-
## Available Skills
10-
11-
### OpenMRS Conch Agent Skill (`SKILL.md`)
5+
### conch-generator skill (`SKILL.md`)
126

137
This skill helps AI assistants generate new OpenMRS ESM microfrontends (conch) from this template. It provides comprehensive guidance on:
148

159
- Setting up a development environment
1610
- Scaffolding new microfrontend projects
1711
- Implementing GenAI-powered features
1812
- Integrating with the OpenMRS 3.x ecosystem
19-
- Working with DHTI (Digital Health Technology & Innovation) services
13+
- Working with DHTI services
2014

21-
**Use this skill when:** You need to create a new DHTI-enabled healthcare application or OpenMRS microfrontend.
15+
**Use this skill when:** You need to create a OpenMRS microfrontend for DHTI.
2216

2317
## Examples
2418

2519
The `examples/` directory contains sample feature requests and use cases that demonstrate how to invoke and use these skills effectively.
2620

27-
- `conch-sample-request.md` - Example of creating a glycemic control widget with GenAI integration
21+
- `conch-sample-request.md` - Example of creating a glycemic control widget with DHTI integration
2822

2923
## How to Use These Skills
3024

@@ -36,7 +30,7 @@ When working with AI coding assistants that support custom skills:
3630

3731
Example invocation:
3832
```
39-
I need to create a new OpenMRS microfrontend using the DHTI template.
33+
I need to create a new OpenMRS microfrontend for DHTI.
4034
Please use the OpenMRS Conch Agent Skill with the following requirements:
4135
[Your feature request here]
4236
```
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
# Example: Glycemic Control Widget: This example demonstrates how to use the OpenMRS Conch Agent Skill to create a patient-specific widget that integrates GenAI capabilities.
1+
# Example: Glycemic Control Widget: This example demonstrates how to use the conch-generator Skill to create a patient-specific widget that integrates GenAI capabilities into OpenMRS using DHTI.
22

33
* Generate a glycemic-advisor conch.
44
* It will display diabetes-related observations for the patient in context with GenAI interpretations and recommendations.
55
* This widget will be displayed in the patient chart, conditions tab.
66
* This widget will use `glycemic_advisor` DHTI elixir service to get GenAI outputs, by default.
7-
* If a patient in context is diabetic (i.e., has a Condition resource with code SNOMED CT 44054006), the widget will display the latest HbA1c and Blood Sugar observations for the patient, along with GenAI interpretations and recommendations from the `glycemic_advisor` elixir service.
7+
* If a patient in context is diabetic (i.e., has a Condition resource with code SNOMED CT 44054006), the widget will display the latest HbA1c and Blood Sugar observations for the patient, along with GenAI interpretations and recommendations from the `glycemic_advisor` DHTI elixir service.

.agents/skills/elixir-generator/README.md

Lines changed: 10 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,28 @@
11
# DHTI Elixir Generator Skill
22

3-
This directory contains an AI agent skill for automatically generating DHTI elixir projects from this template.
3+
This directory contains an AI agent skill for automatically generating DHTI elixir projects using DHTI.
44

5-
## Files
5+
## Directory Structure
66

77
- **SKILL.md**: The main skill definition that guides AI agents through the elixir generation process
88
- **examples/**: Directory containing example requests and use cases
9-
- **basic-request.md**: General guidance and simple examples
9+
- **basic-request.md**: A simple example of requesting an elixir for monitoring blood glucose levels
1010

1111
## How It Works
1212

1313
When an AI agent accesses this skill, it can:
1414

15-
1. Automatically set up a development environment
16-
2. Scaffold a new DHTI elixir project using cookiecutter
17-
3. Implement FHIR-based data retrieval
18-
4. Create LangChain chains for clinical decision support
19-
5. Generate tests and documentation
15+
1. Automatically set up a development environment.
16+
2. Scaffold a new DHTI elixir project.
17+
3. Implement FHIR-based data retrieval.
18+
4. Create LangChain chains for clinical decision support,
19+
5. Generate tests and documentation.
2020

2121
## Usage
2222

2323
To use this skill with an AI agent:
2424

25-
1. Ensure your AI agent has access to this skills directory
26-
2. Describe your elixir requirements, including:
25+
1. Describe your elixir requirements, including:
2726
- Clinical functionality needed
2827
- FHIR resources to query
2928
- Project name and slug (must start with `dhti-elixir-` / `dhti_elixir_`)
@@ -32,10 +31,8 @@ To use this skill with an AI agent:
3231
## Example Request
3332

3433
```
35-
Please create a DHTI elixir that monitors blood glucose and HbA1c levels
34+
Please create a DHTI elixir called glycemic_advisor elixir.that monitors blood glucose and HbA1c levels
3635
for diabetes patients over the last 6 months and provides clinical recommendations.
37-
Project name: dhti-elixir-glycemic
38-
Project slug: dhti_elixir_glycemic
3936
```
4037

4138
See the `examples/` directory for more detailed examples.
@@ -44,7 +41,6 @@ See the `examples/` directory for more detailed examples.
4441

4542
- The AI agent must have access to execute shell commands
4643
- The development environment needs Python and `uv` package manager
47-
- Network access to clone cookiecutter templates
4844

4945
## Output
5046

.agents/skills/start-dhti/README.md

Lines changed: 12 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,6 @@ This directory contains an AI agent skill for orchestrating complete DHTI applic
55
## Overview
66

77
The **start-dhti** skill is an orchestration skill that combines:
8-
- Elixir generation (backend GenAI logic)
9-
- Conch generation (frontend UI components)
108
- Local directory installation (new `-l` flag feature)
119
- DHTI server setup and deployment
1210

@@ -16,103 +14,62 @@ This skill enables end-to-end development of GenAI healthcare applications withi
1614

1715
- **SKILL.md**: The main skill definition with detailed step-by-step instructions
1816
- **examples/**: Directory containing complete workflow examples
19-
- **quick-start.md**: Quick reference guide for common scenarios
17+
- **quick-start.md**: A simple example of generating and starting a DHTI application.
2018

2119
## How It Works
2220

2321
When an AI agent uses this skill, it will:
2422

25-
1. **Generate Backend (Elixir)**:
26-
- Invoke elixir-generator skill to create Python-based GenAI backend
27-
- Implements FHIR integration and clinical logic
28-
- Creates LangServe-compatible service
29-
30-
2. **Generate Frontend (Conch)**:
31-
- Invoke conch-generator skill to create OpenMRS microfrontend
32-
- Implements patient-context-aware UI
33-
- Integrates with DHTI service
34-
35-
3. **Set Up Infrastructure**:
23+
1. **Set Up Infrastructure**:
3624
- Create Docker Compose with necessary services
3725
- Configure OpenMRS, LangServe, FHIR server, etc.
3826

39-
4. **Install from Local Directories**:
27+
2. **Install from Local Directories**:
4028
- Use new `-l` flag to install generated elixir from local directory
4129
- Use new `-l` flag to install generated conch from local directory
4230
- Build Docker images for both components
4331

44-
5. **Start and Verify**:
32+
3. **Start and Verify**:
4533
- Launch all services with Docker Compose
4634
- Verify integration and functionality
4735
- Provide access instructions
4836

37+
4. **Facilitate Hot Reloading**:
38+
- Allow developers to make changes to elixir and conch code
39+
- Restart services to see updates without rebuilding everything
40+
4941
## Usage
5042

5143
### Basic Invocation
5244

5345
```
54-
I need to create a complete DHTI application with the following requirements:
55-
56-
Elixir (Backend):
57-
- [Describe the GenAI functionality, FHIR resources, clinical logic]
58-
59-
Conch (Frontend):
60-
- [Describe the UI components, patient context, user interactions]
61-
6246
Please use the start-dhti skill to generate, install, and start the complete application.
6347
```
6448

65-
### With Specific Requirements
66-
67-
```
68-
Create a DHTI application for glycemic control monitoring:
69-
70-
Elixir Requirements (build using elixir-generator skill):
71-
- Monitor blood glucose and HbA1c levels for diabetic patients
72-
- Query FHIR Observation resources for the last 6 months
73-
- Use LangChain to analyze trends and provide recommendations
74-
- Project name: dhti-elixir-glycemic
75-
- Project slug: dhti_elixir_glycemic
76-
77-
Conch Requirements (build using conch-generator skill):
78-
- Display glycemic control widget in patient chart conditions tab
79-
- Show latest HbA1c and blood glucose readings
80-
- Display AI-generated interpretations and recommendations
81-
- Project name: openmrs-esm-dhti-glycemic
82-
- Only show for patients with diabetes diagnosis (SNOMED CT 44054006)
83-
84-
Please use the start-dhti skill to build this application.
85-
```
86-
8749
## Prerequisites
8850

8951
Users of this skill need:
9052
- Node.js >= 18.0.0
9153
- Docker and Docker Compose
92-
- Python 3.x
54+
- Python 3.x (Optional for local development and testing)
9355
- Sufficient disk space for Docker images (~5-10 GB)
9456

9557

9658
## Troubleshooting
9759

9860
Common issues:
9961

100-
1. **Skill invocation fails**:
101-
- Ensure elixir-generator and conch-generator skills are available
102-
- Check that all prerequisites are installed
103-
- Verify Docker is running
104-
105-
2. **Generation fails**:
62+
1. **Generation fails**:
10663
- Check requirements are clear and specific
10764
- Ensure project names follow conventions
10865
- Verify network connectivity for cookiecutter
10966

110-
3. **Installation fails**:
67+
2. **Installation fails**:
11168
- Verify generated directories exist
11269
- Check paths are correct (absolute paths recommended)
11370
- Ensure directory structure matches expected format
11471

115-
4. **Services don't start**:
72+
3. **Services don't start**:
11673
- Check port availability (80, 8080, 8000)
11774
- Verify Docker has sufficient resources
11875
- Check Docker logs for specific errors

.agents/skills/start-dhti/SKILL.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -203,8 +203,9 @@ NOTE the `Application link` in the output rather than the final display link.
203203
- Monitor logs: `docker compose logs -f`
204204
205205
13. **Hand off with the following instructions:**
206-
- Use the `Application link`: <<application-link>>
207-
- Open this in browser to access the application
206+
- Request the user to run `npx dhti-cli elixir start -n <<elixir-name>>` to start the CDS-Hooks container with the elixir.
207+
- Display the `Application link`: <<application-link>>
208+
- Request to open application link in browser to access it.
208209
209210
### Phase 9: Clean Up (If Needed)
210211
Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,10 @@
1-
# Quick Start Guide
1+
## Minimal for start DHTI with elixir and conch
2+
Use start-dhti skill to:
3+
* Spin up dhti with only langserve modules.
4+
* Install the local elixir glycemic_advisor.
5+
* Install the local conch esm-glycemic-advisor.
6+
* Start the docker container.
7+
* Verify everything is working end to end.
8+
* Start openmrs and it in browser.
29

3-
This is a reference for using the start-dhti skill to create complete DHTI applications.
410

5-
## Minimal Example
6-
7-
8-
Create a simple DHTI application:
9-
10-
1. Spin up dhti with only langserve modules.
11-
2. Install the elixir from the directory workspace/dhti-elixir/packages/glycemic_advisor.
12-
3. Install the conch from the directory workspace/openmrs-esm-dhti/packages/esm-glycemic-advisor.
13-
4. Start the docker container.
14-
5. Verify everything is working end to end.
15-
6. Start openmrs and it in browser.
16-
17-
18-
Use start-dhti skill.

CHANGELOG.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,16 @@
22

33
## [Unreleased](https://github.com/dermatologist/dhti/tree/HEAD)
44

5-
[Full Changelog](https://github.com/dermatologist/dhti/compare/1.3.0...HEAD)
5+
[Full Changelog](https://github.com/dermatologist/dhti/compare/1.3.1...HEAD)
6+
7+
**Closed issues:**
8+
9+
- Add additional models [\#123](https://github.com/dermatologist/dhti/issues/123)
610

711
**Merged pull requests:**
812

13+
- Add supported models list to copilot command flag description [\#124](https://github.com/dermatologist/dhti/pull/124) ([Copilot](https://github.com/apps/copilot-swe-agent))
14+
- Feature/fix skills 3 [\#122](https://github.com/dermatologist/dhti/pull/122) ([dermatologist](https://github.com/dermatologist))
915
- Feature/fix start skill 1 [\#121](https://github.com/dermatologist/dhti/pull/121) ([dermatologist](https://github.com/dermatologist))
1016
- Add GitHub Copilot SDK integration with skill-based streaming AI assistance and stateful conversations [\#120](https://github.com/dermatologist/dhti/pull/120) ([Copilot](https://github.com/apps/copilot-swe-agent))
1117
- Feature/agent skills 2 [\#118](https://github.com/dermatologist/dhti/pull/118) ([dermatologist](https://github.com/dermatologist))
@@ -33,6 +39,10 @@
3339
- Feature/bump fix 1 [\#87](https://github.com/dermatologist/dhti/pull/87) ([dermatologist](https://github.com/dermatologist))
3440
- Feature/copy bootstrap [\#86](https://github.com/dermatologist/dhti/pull/86) ([dermatologist](https://github.com/dermatologist))
3541

42+
## [1.3.1](https://github.com/dermatologist/dhti/tree/1.3.1) (2026-02-14)
43+
44+
[Full Changelog](https://github.com/dermatologist/dhti/compare/1.3.0...1.3.1)
45+
3646
## [1.3.0](https://github.com/dermatologist/dhti/tree/1.3.0) (2026-02-14)
3747

3848
[Full Changelog](https://github.com/dermatologist/dhti/compare/1.2.0...1.3.0)

README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
> 🚀 Dhanvantari rose out of the water with his four hands, holding a pot full of elixirs.
1515
1616
# DHTI
17-
*DHTI enables rapid prototyping, sharing, and testing of GenAI healthcare applications inside an EHR, helping experiments move smoothly into practice. DHTI also includes [skills](/.github/skills/) that generate GenAI components from problem‑oriented [prompts](/prompts/e2e-sample.md).*
17+
*DHTI enables rapid prototyping, sharing, and testing of GenAI healthcare applications inside an EHR, helping experiments move smoothly into practice. DHTI also includes [skills](/.agents/skills/) that generate GenAI components from problem‑oriented [prompts](/.agents/skills/start-dhti/examples/e2e-sample.md).*
1818

1919
### Why?
2020

@@ -32,7 +32,12 @@ DHTI includes ready‑to‑use [skills](/.agents/skills/) that can prompt agenti
3232

3333
Other skills from the open agent skills ecosystem may be useful too! For example, use `npx skills find clinical trial` to find clinical trial related skills. From the results, you can use `npx skills add <skill-name>` to use the skill in your agentic platform. (e.g.`npx skills add anthropics/healthcare@clinical-trial-protocol-skill`)
3434

35-
**🤖 [AI-Powered Workflow with GitHub Copilot SDK:](/notes/COPILOT.md) - WIP**
35+
## **🤖 [AI-Powered Workflow with GitHub Copilot SDK:](/notes/COPILOT.md) - WIP**
36+
### Quick example
37+
```bash
38+
npx dhti-cli copilot --model gpt-5.3-codex --skill elixir-generator --prompt "Generate an elixir glycemic_advisor that summarizes diabetic patients' latest lab results and medications"
39+
npx dhti-cli copilot --model gpt-5.3-codex --skill start-dhti --prompt "Start the glycemic_advisor elixir and display in CDS-Hooks sandbox"
40+
```
3641

3742
## Try it out
3843
[[Cheatsheet](/notes/cheatsheet.md) | [Download PDF Cheatsheet](https://nuchange.ca/wp-content/uploads/2026/01/dhti_cheatsheet.pdf)]

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "dhti-cli",
33
"description": "DHTI CLI",
4-
"version": "1.3.1",
4+
"version": "1.3.2",
55
"author": "Bell Eapen",
66
"bin": {
77
"dhti-cli": "bin/run.js"

0 commit comments

Comments
 (0)