Skip to content
Skills Library
Personal productivity · Automation

do.init

/do.init

Initialize or safely upgrade a DeepOrbit Obsidian vault. Use when the user asks to set up DeepOrbit, create the vault folders, migrate legacy Chinese folder names, repair a partial installation, or generate deeporbit.json.

Repository
deeporbit ↗
Licence
MIT
Last repository change
08.10.2026

Assessment and security

91/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content31 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Initialize or safely upgrade a DeepOrbit Obsidian vault. Use when the user asks to set up DeepOrbit, create the vault folders, migrate legacy Chinese folder names, repair a partial installation, or generate deeporbit.json.

Original author description

Initialize or safely upgrade a DeepOrbit Obsidian vault. Use when the user asks to set up DeepOrbit, create the vault folders, migrate legacy Chinese folder names, repair a partial installation, or generate deeporbit.json.

How it works

SKILL.md has no level-two headings · 25 lines, 211 words

SKILL.md preview
---
name: do.init
description: Initialize or safely upgrade a DeepOrbit Obsidian vault. Use when the user asks to set up DeepOrbit, create the vault folders, migrate legacy Chinese folder names, repair a partial installation, or generate deeporbit.json.
---

# Initialize DeepOrbit

Run the deterministic initializer from the installed CLI and point it at the
DeepOrbit repository checkout that should be materialized into the vault:

```bash
deeporbit --vault "<vault-path>" init --source "<deeporbit-repo-path>"
```

If the `deeporbit` executable is unavailable, run `PYTHONPATH=<repo>/src python -m deeporbit --vault "<vault-path>" init --source "<repo>"`.

The command is idempotent. It creates missing folders, including `15_Writings`, preserves existing notes, merges legacy localized folders only when safe, and reports conflicting files without overwriting either copy.

Initialization materializes the workflow skills into `99_System/DeepOrbit/skills/`, writes `99_System/DeepOrbit/skills-index.json`, overlays missing system templates/prompts/Bases, refreshes mentor guides, and copies a curated runtime bundle into `99_System/DeepOrbit/repo/`. The bundle is the project-level handoff surface: it includes skills, commands, prompts, hooks, CLI source, MCP, docs, and manifests, but excludes `.git`, virtualenvs, caches, build outputs, `node_modules`, and generated agent install directories.

External workspaces should install only the global `do.link` connector; after `init`, the vault itself carries the workflow catalog needed for routing.

After initialization:

1. Read the JSON result.
2. If `conflicts` is non-empty, show every path and ask the user how to merge it; do not delete either file.
3. Run `deeporbit --vault "<vault-path>" doctor`.
4. Explain which optional capabilities are available. Missing Obsidian CLI, ChromaDB, Tasks, Dataview, or Calendar must not be treated as initialization failures.
Files in this package (2)
  • SKILL.md 2 KB
  • agents/openai.yaml 1 KB

Versions

The database has no other skills named do.init.

Database snapshot: 13.11.2026 · package version fcccadabb102 (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

  • 95do.link
    Connect the current workspace to an existing DeepOrbit Obsidian vault elsewhere on disk and run its workflows by natural language. Use when the user wants to link or register a vault path, work on a vault outside the current directory, or triggers vault actions (daily plan,…
  • 100init
    Create a new vault from the kit's templates — folders, CLAUDE.md schema, hot cache, index, log and settings — in an empty folder or an existing Obsidian vault, without overwriting anything; then fill the identity card and point to the Obsidian setup. Use when the user asks to…
  • 100kb-init
    Use when setting up a new knowledge base, bootstrapping an Obsidian vault, or when user says 'init kb', 'new knowledge base', 'create kb', or 'setup vault'. Triggers on any request to initialize or scaffold a knowledge base project.
  • 100wiki-setup
    Scaffold an LLM wiki layer in an Obsidian vault — 6 type folders + index/log/hot/manifest + .obsidian-wiki.config. Use to init wiki/ first-time or rebuild. Not repo-wiki:init / dbt-wiki:init; full vault setup → obsidian-vault-setup.
  • 100oh-my-obsidian-setup
    Use this skill when the user wants to initialize oh-my-obsidian, create or attach an Obsidian vault, configure persistent vault resolution, or prepare Obsidian Git integration.
  • 91do.agenda
    Build a current agenda from DeepOrbit Markdown tasks. Use when the user asks what to do today, what is overdue, what is upcoming, for a task review, or for a daily planning summary across Inbox, Diary, and Projects.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.