K-Dense-AI/scientific-agent-skills / skills/clinical-decision-support
clinical-decision-support
VerifiedPrepares and validates research-only clinical decision-support evaluation, evidence-profile, cohort, survival, biomarker/model, privacy, and governance artifacts. Supports aggregate or synthetic research documentation and traceability, excluding patient care and live clinical operation.
references/decision_logic_traceability.md
View on GitHub# Decision-Logic Traceability
## Scope
“Decision logic” here means research and governance logic only:
- evidence inclusion/exclusion;
- data-quality gates;
- validation acceptance criteria;
- release holds;
- documentation completeness;
- change-control approval;
- human-review checkpoints.
Do not encode diagnostic, treatment, dosing, triage, alarm, urgency, bedside, or patient-facing logic.
## Matrix Purpose
A traceability matrix links each rule to:
- its source and rationale;
- input/precondition;
- deterministic statement;
- bounded output kind;
- verification tests;
- owner and reviewer;
- version and status;
- known limitations and change history.
The matrix documents logic. It does not execute arbitrary expressions.
## Allowed Node Types
- `input_check`
- `data_quality_gate`
- `evidence_rule`
- `validation_gate`
- `documentation_gate`
- `human_review`
- `release_gate`
- `monitoring_gate`
Allowed output kinds:
- `include_evidence`
- `exclude_evidence`
- `flag_for_review`
- `validation_status`
- `documentation_status`
- `release_hold`
- `monitoring_status`
There is deliberately no generic “action” node.
## Required Fields
### Matrix Metadata
- logic ID and title;
- version/status/owner;
- research-only intended use;
- prohibited uses;
- data level;
- source ledger;
- human-review requirement;
- change summary;
- monitoring and retirement criteria.
### Per Node
- unique node ID;
- type;
- precondition/input;
- logic statement in plain language;
- output kind;
- output value;
- source IDs;
- rationale;
- validation tests;
- owner;
- reviewer role;
- status.
## Rule-Writing Guidance
Write rules so an independent reviewer can reproduce the result without hidden knowledge.
Good:
> If an evidence record lacks a stable citation and retrieval date, set output kind `flag_for_review` with value `missing_source_provenance`.
> If external validation is absent, set `release_hold` to `true` for claims of transportability.
Unsafe and prohibited:
> If a person's score is high, trigger an urgent alert.
> If a biomarker is positive, recommend a therapy.
## Validation Tests
For each node include:
- positive case;
- negative case;
- boundary case;
- missing/invalid input;
- source/version regression;
- expected output;
- reviewer and date.
For the matrix as a whole include:
- unreachable or orphan nodes;
- conflicting outputs;
- cycles;
- missing sources;
- stale versions;
- bypass paths around human review;
- rollback and retirement behavior.
The bundled helper validates identifiers, allowed node/output types, citations, and required review fields, then emits CSV. It does not parse or execute the logic statement. Invalid matrices produce diagnostics without CSV export; `--strict` also withholds export when review warnings remain.
## Change Control
For any change:
1. state the reason;
2. link new evidence or requirement;
3. identify affected nodes and downstream artifacts;
4. update tests;
5. independently validate;
6. record approval;
7. define rollout/rollback when applicable;
8. retain the previous version;
9. update monitoring;
10. retire superseded logic explicitly.
## Script
```bash
python3 scripts/decision_logic_traceability.py \
assets/decision_logic_traceability_template.json
```
The output is a documentation matrix, not executable clinical logic.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |