VolderLu/setup
skills/setup/SKILL.md
Initialize a new TwinMind vault in the current directory. Creates TwinMind.md configuration and vault directory structure from templates. Use when starting a fresh knowledge vault or setting up TwinMind in a new project.
$ install --global
skillsauthnpx skillsauth add VolderLu/TwinMind setupInstall 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 3, 2026, 2:26 AM137.2s1 file scanned
SKILL.md
- name:
- setup
- description:
- Initialize a new TwinMind vault in the current directory. Creates TwinMind.md configuration and vault directory structure from templates. Use when starting a fresh knowledge vault or setting up TwinMind in a new project.
- license:
- MIT
TwinMind Setup
Initialize a new TwinMind vault in the current working directory.
Pre-flight Checks
Before proceeding, check for existing installations:
- TwinMind.md exists → Warn: "TwinMind.md already exists in this directory. Overwrite?" Ask user to confirm or abort.
- Old-style
.claude/skills/tm-*directories exist → Warn: "Detected old-style TwinMind installation (.claude/skills/tm-*). This plugin-based setup is separate. Consider removing old files to avoid confusion." - Vault directory already exists and contains files → Warn: "Directory
<vault_dir>/already exists with content. Setup will not overwrite existing vault data. Only missing structure files will be created."
If all checks pass or user confirms, proceed.
Interactive Configuration
Ask the user for customization (or accept defaults):
- Vault directory name — default:
vault - Locale — default:
zh-TW - Domains — default: empty list (AI creates as needed)
Setup Steps
Resolve Plugin Root
Setup needs the plugin's absolute path to copy templates from. Read <cwd>/.claude/twinmind/config.json with the Read tool and use its pluginRoot field as <plugin-root> in the steps below.
Cold-start fallback: if <cwd>/.claude/twinmind/config.json does not exist, the SessionStart hook has not run for this vault yet (TwinMind.md is required to trigger it). In that case:
- Use the Write tool to create
<cwd>/TwinMind.mdwith minimal frontmatter (justvault_dir: vault\nvault_name: TwinMind\nlocale: zh-TW). - Tell the user: "請執行
exit退出 Claude Code，然後claude重新啟動 session (讓 SessionStart hook 寫入 plugin 路徑)，再次執行/setup完成餘下步驟。" - Stop.
Copy and Customize
- Copy
<plugin-root>/templates/TwinMind.mdto<cwd>/TwinMind.md. - Update frontmatter values based on user's choices (
vault_dir,locale,domains). - Copy
<plugin-root>/templates/vault/directory structure to<cwd>/<vault_dir>/:- Create all subdirectories:
System/,Cards/,Sources/,Atlas/,PARA/Inbox/,PARA/Actions/,PARA/Projects/,PARA/Archive/,PARA/Areas/,PARA/Tasks/. - Copy initial files:
System/vault-index.json,Home.md,PARA/Dashboard.md. - Skip directories/files that already exist.
- Create all subdirectories:
- Create
.gitignorein<cwd>if not exists, listing both.obsidian/and.claude/twinmind/(the latter holds plugin-generated shims that regenerate on every session start).
Completion
Report:
- Created TwinMind.md at project root
- Created vault structure at
<vault_dir>/ - Next steps: "Open this directory in Obsidian to browse your vault. Start talking to Claude to capture knowledge!"
Related Skills
VolderLu/task
testing
VerifiedTrustedCommunity
TwinMind task engine — manages standalone tasks (life chores, errands, quick todos). Use this skill when the user mentions a simple, concrete thing they need to do that doesn't belong to any project or action. Classic triggers: short imperative sentences like '買牛奶', '繳電費', '回覆 email', '預約牙醫', or explicit task operations like '加個待辦', 'add task', 'task done', '完成 task', '刪除 task', 'delete task', '列出 tasks', 'list tasks', '待辦清單'. The distinguishing feature of a standalone task is that it's too small for an Action and not tied to any project. If the user mentions a project name, route to twinmind:project. If it's a multi-step endeavor, consider twinmind:action instead.
15SKILL.mdUpdated Apr 23, 2026
VolderLu/router
development
VerifiedTrustedCommunity
Classifies user knowledge-base input into one of 9 intent categories (capture, inbox, query, project, action, task, area, review, connect) using signal words, priority rules, compound intent handling, and fuzzy fallback matching. Invoke BEFORE dispatching to any twinmind:* skill when the user provides knowledge-base input. Do NOT skip this step — the session startup skeleton only has a summary table; this skill has the complete rules needed for accurate classification.
15SKILL.mdUpdated Apr 23, 2026
VolderLu/review
development
VerifiedTrustedCommunity
TwinMind review and maintenance engine. Use for vault health checks, seed card review, index verification/rebuild, MOC management, and vault status summaries. Triggers on: 'vault status', '知識庫狀況', 'health report', '健康報告', 'verify index', '檢查索引', 'rebuild index', '重建索引', 'review seeds', '有哪些 seed', 'update MOC', or any request about knowledge base maintenance and overview.
15SKILL.mdUpdated Apr 23, 2026
VolderLu/query
data-ai
VerifiedTrustedCommunity
Searches stored cards by domain, type, status, or keyword. Recommends semantically related cards using AI language understanding. Queries inbox, action, task, area, and project data from the vault index. Use when the user asks to search, find, list, filter, or browse cards, or wants recommendations for related content. Triggers: '搜尋', '找', 'search', 'find', '列出', 'list', '有沒有', '跟X相關的', '有幾張', 'how many', '統計'.
15SKILL.mdUpdated Apr 23, 2026