Skip to content
Skills Library
Science & research · Review & audit

setup-medsci

/setup-medsci

Use when a skill fails for a missing tool or the environment needs checking. Diagnoses Python, R, Node, Claude Code, Git, Zotero and configured MCP servers and prints a pass/fail table with links to the setup docs. Read-only; installs nothing.

Licence
MIT
Last repository change
22.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when a skill fails for a missing tool or the environment needs checking. Diagnoses Python, R, Node, Claude Code, Git, Zotero and configured MCP servers and prints a pass/fail table with links to the setup docs. Read-only; installs nothing.

Original author description

Use when a skill fails for a missing tool or the environment needs checking. Diagnoses Python, R, Node, Claude Code, Git, Zotero and configured MCP servers and prints a pass/fail table with links to the setup docs. Read-only; installs nothing.

How it works

  1. Workflow
  2. Output
Original SKILL.md headings · 80 lines, 523 words
SKILL.md preview
---
name: setup-medsci
description: Use when a skill fails for a missing tool or the environment needs checking. Diagnoses Python, R, Node, Claude Code, Git, Zotero and configured MCP servers and prints a pass/fail table with links to the setup docs. Read-only; installs nothing.
metadata:
  triggers: "setup, install, environment, diagnostic, check setup, why doesn't this work, missing python, missing R, MCP not connected, 환경 설정, 설치 점검"
---

# Setup-MedSci Skill

Diagnose only. **Never install, upgrade or configure anything** — no `brew install`,
`winget install`, `pip install`, `Rscript -e 'install.packages(...)'`, and no edits to
`~/.claude.json` or any MCP configuration (read `claude mcp list` only) — because auto-installers
for system Python and R are a support nightmare for non-developer users. If a tool is missing,
the user follows the setup doc themselves. Skill versions and content are out of scope
(`validate_skills.sh`, `/manage-project status`).

The diagnostic table is in English so it can be pasted into a GitHub issue. Remediation links
point to the `docs/setup/` guides in the medsci-skills repository, and only these five exist:
`docs/setup/README.md`, `docs/setup/mac.md`, `docs/setup/windows.md`, `docs/setup/mcp-setup.md`,
`docs/setup/common-issues.md`.

## Workflow

### Phase 1: Detect OS

```bash
uname -s
```

- `Darwin` → macOS → `docs/setup/mac.md`
- `Linux` → Linux (similar tooling to Mac) → `docs/setup/mac.md`
- `MINGW*`, `MSYS*`, `CYGWIN*`, or detection failure on Windows → `docs/setup/windows.md`

### Phase 2: Run Diagnostic Commands

Read `references/setup-checklist.md` and run every check in it — R1-R5 required, O1-O5 optional —
with its detect command, version command, minimum version and status rule. Use `command -v <tool>`
first to detect presence without running it (avoids triggering long initialization). Capture the
version output and the exit code, and report the version exactly as printed: if a command fails,
report the failure verbatim rather than a version that is "probably" installed. If `command -v`
finds the tool but the version command or its parse fails, mark the row ❌ and report the failing
command — the install is broken, not just outdated. An MCP server is ✅ only when
`claude mcp list` shows it connected; configured-but-disconnected is ⚠️.

### Phase 3: Emit Checklist Table

Print a single Markdown table to stdout in this exact format, one row per check, with the doc
link from the reference for the detected OS:

```
## MedSci Skills Setup Diagnostic

OS detected: <macOS | Linux | Windows>
Date: <YYYY-MM-DD>

| Component | Status | Detected | Required | Action |
|---|:---:|---|---|---|
| Python 3.11+ | ✅ / ❌ | 3.11.9 | 3.11+ | OK / See docs/setup/mac.md Step 2 |
| MCP: zotero | ✅ / ❌ / ⚠️ | Connected | optional | OK / See docs/setup/mcp-setup.md |

Summary: <X required components passed, Y missing>
Next step: <one-sentence action>
```

Status legend:
- ✅ Present and meets minimum version
- ❌ Missing or below minimum version
- ⚠️ Present but optional and not connected

### Phase 4: Suggest Remediation

Use the reference's Summary Rules for the closing sentence.

- Everything required ✅ → point to Demo 1:
  `cd ~/medsci-skills/demo/01_wisconsin_bc && claude '/orchestrate --e2e'`.
- Any **required** row ❌ → print its doc link and tell them to follow that step. Do **not** offer
  to install; the doc tells them exactly what to copy-paste.
- Only **optional MCP** rows ❌ → explain that MedSci Skills work without MCP servers, but
  `lit-sync`, `verify-refs` and `write-paper` are smoother with Zotero MCP; link
  `docs/setup/mcp-setup.md`.

## Output

The diagnostic report goes to stdout. If the user asks for a copyable report (e.g. for a GitHub
issue), also write it to `~/.medsci-skills/diagnostic-YYYY-MM-DD.md` and tell them where it is.
Files in this package (3)
  • SKILL.md 4 KB
  • skill.yml 1 KB
  • references/setup-checklist.md 4 KB

Versions

The database has no other skills named setup-medsci.

Database snapshot: 13.11.2026 · package version 70abe0c2aad2 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100orchestrate
    Use when the user describes a research goal without naming a skill, or the task spans several skills. Classifies the request, plans the order and routes to the right medsci-skills skill(s) instead of producing their output itself.
  • 100zotero
    面向不同研究领域的 Zotero 技能:原文定位问答、全文翻译与精读、原生高亮和中文批注、双语 PDF/逐段 Markdown、论文证据对比表、综述与引用追踪;支持 OpenAlex / Crossref / 知网导出文件三种文献来源,术语和数字复核、可追溯纠错,另有归集分类、BibTeX 和草稿引用。用户提到 Zotero、解释论文、翻译、精读、标注、文献比较、综述、中文文献或知网时使用。
  • 90che-zotero-mcp
    Guide for using Zotero MCP tools to manage references, search academic papers, generate citations, and build knowledge graphs. Use when user asks about Zotero, citations, bibliography, literature review, academic search, or knowledge graph.
  • 100zotero-library
    Find, add and file papers in the user's Zotero library for the current project without changing anything the user already has. Use when a task needs the user's own papers, their PDFs' full text, citations from their library, or adding a paper to the project's reading list.
  • 90zotero-paper-deep-read
    在 Zotero 中定位指定或当前打开的论文,阅读正文与补充材料,按四部分十项结构进行固态电池文献深度解析,并新建子笔记保存结果。适用于“解读这篇文献并写入 Zotero 笔记”等请求。
  • 90zotero-skills
    Full CRUD on a Zotero library: search, add, update, tag, trash/restore, delete, merge duplicates, and attach PDFs. Writes use pyzotero's Web API even though the separately configured zotero MCP server's tools are read only: call credentials_status() to check for a key (never…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.