Skip to content
cccskills
FreePublished on GitHub

obsidian-project-bootstrap

Set up an Obsidian knowledge base for a research repository containing code and Markdown. It creates project links, planning notes, source inventories, and code summaries, importing structure and summaries while leaving large research artifacts out.

OriginalShow the original 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.

Works withObsidian

Run score Not tested

See how to install

Good for

  • Starting a research project's knowledge base
  • Bringing a code and Markdown project into Obsidian
  • Creating project plans and source inventories
  • Preparing repository links for future syncing

Files included (2)

  • SKILL.md2.7 KB
  • references/BOOTSTRAP-RUNBOOK.md1.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:
    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:
    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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a1

FreeSummary

Turn a broad research idea into clear, testable questions. Compare familiar and less conventional approaches, structure the selected question around its population and methods, and assess variables, feasibility, and potential theoretical contributions.

  • Turn a research topic into testable questions
  • Narrow an overly broad research question
  • Compare alternative research angles
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

a2

FreeSummary

Helps build a research framework by comparing theories, mapping relationships between variables, and deriving testable hypotheses. Explores less conventional options, examines weaknesses and competing explanations, and produces diagrams with anticipated reviewer objections.

  • Comparing theories for a research question
  • Deriving hypotheses from relationships between variables
  • Examining weaknesses and anticipated reviewer objections
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

a5

FreeSummary

Clarify the philosophical assumptions behind a research project and check whether they fit the proposed methods. Get a reasoned research stance, draft proposal wording, and guidance for explaining how the researcher's background and values shape the study.

  • Clarifying philosophical foundations for a research proposal
  • Explaining why the chosen research methods fit the study
  • Drafting a statement about the researcher's position
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

academic-paper

FreeSummary

Plan and draft academic papers through specialized agent roles covering literature, arguments, citations, and review. Get chapter guidance, revision roadmaps, Traditional Chinese and English abstracts, and documents formatted as LaTeX, DOCX, PDF, or Markdown.

  • Planning a paper chapter by chapter
  • Drafting a paper from research materials
  • Turning reviewer comments into a revision roadmap
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

Turn a detailed outline into a philosophy or interdisciplinary manuscript. Draft chapters with repeated quality reviews, check terminology and arguments across sections, and prepare the manuscript, evaluation reports, abstract, and metadata for submission.

  • Draft a full paper from a detailed outline
  • Review argument and citation quality chapter by chapter
  • Check terminology and argument flow across chapters
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

Simulate academic peer review through five reviewer roles tailored to the paper's field. Receive separate critiques, an editorial decision, and a prioritized revision roadmap, or check whether a revised manuscript addresses earlier comments.

  • Review a manuscript before journal submission
  • Examine research methods and statistical validity
  • Challenge core arguments and alternative explanations
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

See all skills by brycewang-stanford

Report a problem with this skill