ajayjohn/doctor
skills/doctor/SKILL.md
Check whether TARS is installed correctly and the local helper can read and write the workspace
$ install --global
skillsauthnpx skillsauth add ajayjohn/tars-work-assistant doctorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 8, 2026, 3:41 AM131.2s1 file scanned
SKILL.md
- name:
- doctor
- description:
- Check whether TARS is installed correctly and the local helper can read and write the workspace
- user-invocable:
- true
- purpose:
- |-
- scope:
- setup,diagnostics,recovery
Doctor: check TARS install
Use this skill when setup fails, TARS cannot write to the workspace, or the user asks whether their install is healthy.
Step 1: Try the local helper check
Call mcp__tars_vault__runtime_info with the active workspace path if known.
If it returns:
required_runtime: "ok": tell the user the local TARS helper is connected.required_runtime: "error": show the recovery block in Step 3.optional_search: "degraded": mention that semantic search enhancements are unavailable, but setup and keyword search still work.
Do not treat missing fastembed or sqlite-vec as setup blockers.
Step 2: Check workspace consistency
If the helper is connected and a workspace path is known, summarize:
- active workspace path
- whether
_system/install.yamlexists - whether the workspace is writable
- whether setup looks complete
Keep the first answer short. Put technical details under Details only if needed.
Step 3: Missing local helper recovery
If mcp__tars_vault__runtime_info is unavailable, do not mention raw MCP tool names in the user-facing response. Say:
I can't safely finish TARS setup because the local TARS helper is not connected.
This helper creates and checks the workspace in the background. This is not an Obsidian, calendar, task, email, or Slack issue. Those integrations are optional.
Try this:
1. Make sure the TARS plugin is enabled in Claude.
2. Restart Claude so the local helper starts.
3. Run `/doctor` again, or ask "check my TARS install."
4. When the check passes, run `/welcome`.
Details: TARS needs Python 3.10+ and the bundled `tars-vault` helper. It does not require the Python `mcp` package for first setup. Semantic search packages are optional and can be added later.
If the user is in a code checkout and asks for technical help, suggest:
python3 scripts/doctor.py --workspace "<path to your TARS workspace>"
Step 4: Closeout
If the check passes, end with:
TARS is ready. If this is your first run, use `/welcome`, or just say "set up TARS."
If there are warnings only, say setup can continue and name the feature that will be degraded.
Related Skills
ajayjohn/ideate
tools
VerifiedTrustedCommunity
Open Collider semantic collision engine for non-obvious idea generation
1SKILL.mdUpdated May 24, 2026
ajayjohn/start
content-media
VerifiedTrustedCommunity
Zero-setup quick demo. Accept pasted content or a natural request and produce a useful structured artifact in under 5 minutes.
1SKILL.mdUpdated May 7, 2026
ajayjohn/lint
development
VerifiedTrustedCommunity
Vault hygiene — broken links, orphans, schema violations, staleness, contradictions, sparse notes, framework state drift
1SKILL.mdUpdated May 7, 2026
ajayjohn/welcome
tools
VerifiedTrustedCommunity
Deterministic first-run setup contract for the TARS Markdown workspace, with optional Obsidian mode and deferred setup continuation
1SKILL.mdUpdated Apr 2, 2026