dull-bird/deeporbit · Archived

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.

First seen Jul 21, 2026

Installation

$ npx skills add dull-bird/deeporbit --skill do.init

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from dull-bird/deeporbit · top by installs.

npx skills add dull-bird/deeporbit

Browse all from dull-bird/deeporbit

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 5
License LICENSE
Default branch master
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,926 B
  • docs SUMMARY.md 237 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3 installs

SKILL.md

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:

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 99System/DeepOrbit/skills/, writes 99System/DeepOrbit/skills-index.json, overlays missing system templates/prompts/Bases, refreshes mentor guides, and copies a curated runtime bundle into 99System/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, nodemodules, 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.