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.
- Author
- Aperivue ↗
- Repository
- medsci-skills ↗
- Licence
- MIT
- Last repository change
- 22.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.
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
- Workflow
- Output
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…