brycewang-stanford/Auto-Empirical-Research-Skills / skills/33-Galaxy-Dawn-claude-scholar/skills/obsidian-project-bootstrap
obsidian-project-bootstrap
VerifiedThis skill should be used when the user asks to start a new research project, import an existing code-plus-Markdown repository into Obsidian, or bind the current repository to a compact research knowledge base for future syncing.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| references/BOOTSTRAP-RUNBOOK.md | markdown | 1.1 KB |
SKILL.md
View on GitHub---
name: obsidian-project-bootstrap
description: This skill should be used when the user asks to start a new research project, import an existing code-plus-Markdown repository into Obsidian, or bind the current repository to a compact research knowledge base for future syncing.
---
# Obsidian Project Bootstrap
Bootstrap a project knowledge base for the current repository.
## Role in the workflow
This is a **supporting skill**.
Use `obsidian-project-memory` as the main workflow authority. Use this skill only when a repository still needs its initial binding or rebuild.
## When to use
- The user says “start a new research project”.
- The user has an existing repo with code plus Markdown and wants an Obsidian knowledge base generated automatically.
- `obsidian-project-memory` detects a research-project candidate but no existing binding.
## Required input
Resolve the vault path from one of:
1. explicit user input,
2. `OBSIDIAN_VAULT_PATH`.
## Procedure
1. Identify the repository root.
2. Run a preflight detect step first:
```bash
python3 "${CLAUDE_PLUGIN_ROOT}/skills/obsidian-project-memory/scripts/project_kb.py" detect --cwd "$PWD"
```
3. Only if the repo is unbound and should be imported, run bootstrap:
```bash
python3 "${CLAUDE_PLUGIN_ROOT}/skills/obsidian-project-memory/scripts/project_kb.py" bootstrap --cwd "$PWD" --vault-path "$OBSIDIAN_VAULT_PATH"
```
4. Verify that bootstrap created at least:
- `.claude/project-memory/registry.yaml`
- `.claude/project-memory/<project_id>.md`
- `Research/{project-slug}/00-Hub.md`
- `Research/{project-slug}/01-Plan.md`
- `Research/{project-slug}/Knowledge/Source-Inventory.md`
- `Research/{project-slug}/Knowledge/Codebase-Overview.md`
5. If the imported project still lacks real background or experiment context, switch to an agent-first pass:
- read the most informative repo docs and code entry points,
- synthesize durable notes into `Knowledge/`, `Papers/`, `Experiments/`, `Results/`, or `Writing/`,
- avoid placeholder notes.
6. Summarize the created knowledge base and the next recommended canonical notes to fill in.
## Notes
- The bootstrap process imports **structure and summaries**, not raw datasets, caches, checkpoints, or the whole code tree.
- Ignore `.git`, `.venv`, `node_modules`, caches, checkpoints, binaries, and other heavy artifacts.
- The default vault is compact: `00-Hub.md`, `01-Plan.md`, `Knowledge/`, `Papers/`, `Experiments/`, `Results/`, `Writing/`, `Daily/`, `Archive/`.
- If `python3` is unavailable in the current shell, use the system Python interpreter that can run `project_kb.py` and say so explicitly.
## References
- `references/BOOTSTRAP-RUNBOOK.md` - preflight decisions, failure modes, and post-bootstrap verification
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |