Clinical Notes Search with Trioexplorer

VerifiedCaution

Search and explore patient clinical notes using Trioexplorer CLI. Support keyword, semantic, and hybrid search types with cohort filtering capabilities.

Sby Skills Guide Bot
Data & AIBeginner
3/9/2026
Claude CodeCursorCodex
#clinical-notes#semantic-search#cli#healthcare#cohort-analysis

Recommended for

Automated summary

Searches clinical notes through the trioexplorer CLI, covering keyword, semantic and hybrid search, cohort listing and search-history lookups.

Strengths

  • Three search modes (keyword, semantic, hybrid) with toggleable semantic reranking and adjustable vector weight
  • Cohort-scoped filtering plus table, JSON and CSV output that can be piped straight into other tools
  • Discovery commands (cohorts, notetypes, entities, filters) and history statistics for exploring the database

Limitations

  • Requires the trioexplorer CLI to be installed and TRIOEXPLORER_API_KEY to be set
  • Gives no guidance on patient-data privacy, access auditing or compliance
  • Search result volume is capped by -k only; no documented paging for larger result sets
When to use it

Use when the user wants to search clinical notes, list cohorts, or review search history in the Trioexplorer database.

When not to use it

Avoid when the CLI is not installed, the API key is missing, or the user lacks authorization to access the clinical data.

Security analysis

Caution
Quality score78/100

Nothing here is destructive or exfiltrating: there are no curl|sh pipes, no rm -rf, no base64 payloads, and no attempts to disable safeguards. The risk profile is that of a legitimate but powerful wrapper around a clinical-data CLI — it runs arbitrary shell commands against a PHI store and offers a debug mode that may log sensitive content. That lands in 'caution' rather than 'safe', and users should treat outputs and logs as regulated data.

Findings
  • •Skill grants Bash and drives a CLI that queries a clinical-notes database, so it operates on highly sensitive PHI; no guardrails are documented around de-identification, retention, or where output is written.
  • •The `--debug` global flag enables request/response logging, which could persist patient note text or API responses to disk/logs unbidden.
  • •Requires `TRIOEXPLORER_API_KEY` in the environment; the skill does not instruct the agent to avoid echoing or persisting the key, and `--debug` output could expose auth headers.
  • •Commands are invoked by bare name (`trioexplorer`), so the binary resolved from PATH is implicitly trusted; no provenance/version check is described.
  • •Unrestricted query/cohort/user-id arguments are passed straight to the CLI, allowing broad enumeration of cohorts, entities, and other users' search history.
How this analysis is made

Examples

Semantic note search
Search the clinical notes for patients having trouble with blood sugar control, using semantic search and return 20 results as JSON.
Cohort-scoped search
Within cohorts abc123 and def456, find notes mentioning chest pain and show the full note text.
Explore the database
List the available cohorts and note types in trioexplorer, then show my recent search history.

name: trioexplorer description: Search clinical notes using the Trioexplorer CLI. Use when the user wants to search patient notes, list cohorts, view search history, or explore the clinical notes database. allowed-tools: Bash

Trioexplorer CLI

Search clinical notes using the trioexplorer CLI. The CLI requires TRIOEXPLORER_API_KEY to be set.

Commands

Search clinical notes

trioexplorer search "query" [options]

Options:

  • -k N — Number of results (default: 10)
  • --type TYPE — Search type: keyword, semantic, or hybrid (default)
  • --cohort-ids IDS — Comma-separated cohort IDs to search
  • --format FORMAT — Output: table (default), json, or csv
  • --full-text — Show full note text
  • --rerank false — Disable semantic reranking
  • --vector-weight N — Weight for vector vs keyword (0.0-1.0)

List resources

trioexplorer list cohorts [--limit N]
trioexplorer list notetypes [--search TEXT]
trioexplorer list history [--page N] [--user-id ID]
trioexplorer list entities
trioexplorer list filters [--field NAME]

Statistics

trioexplorer stats history [--date-from DATE] [--date-to DATE]

Global options

  • --debug — Enable request/response logging
  • --help — Show help for any command

Examples

Search for diabetes-related notes:

trioexplorer search "diabetes management" -k 20

Semantic search with JSON output:

trioexplorer search "patient having trouble with blood sugar" --type semantic --format json

Search within specific cohorts:

trioexplorer search "chest pain" --cohort-ids abc123,def456

Task: $ARGUMENTS

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/clinical-notes-search-with-trioexplorer-mmio713e/download' --output '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md.part' && mv '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md.part' '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

Tools declared by the author (check availability in your agent): Bash

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code
test -f '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md' && test -s '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/trioexplorer' && cp -R '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e' '.claude/skills/trioexplorer'

Cursor
test -f '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md' && test -s '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/trioexplorer' && cp -R '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e' '.cursor/skills/trioexplorer'

Codex
test -f '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md' && test -s '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/trioexplorer' && cp -R '.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e' '.agents/skills/trioexplorer'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation
openskills install './.skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e'

openskills read 'clinical-notes-search-with-trioexplorer-mmio713e'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/clinical-notes-search-with-trioexplorer-mmio713e/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills