Skip to content
cccskills
FreePublished on GitHub

sync-upstream-obsidianos

Pull structural updates from upstream ObsidianOS into the local vault.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Sync Upstream ObsidianOS

Shortcut to run .scripts/sync-upstream.sh.

Usage

CommandWhat it does
/sync-upstream-obsidianosPreview and merge upstream updates
/sync-upstream-obsidianos previewPreview only — show what's new without merging

Workflow

1. Check prerequisites

  • Verify upstream remote exists: git remote get-url upstream. If missing, tell the user to add it:
    git remote add upstream <url-to-upstream-repo>
    
  • Verify working tree is clean (git status --short). If dirty, ask the user to commit or stash first.

2. Preview

Run .scripts/sync-upstream.sh --preview and show the output (new commits and changed files).

If there are no new commits, report "already up to date" and stop.

If the user only asked for preview, stop here.

3. Confirm and merge

Present the preview results and ask the user to confirm before merging.

On confirmation, run the full sync:

echo y | ./.scripts/sync-upstream.sh

4. Report results

Show the merge outcome:

  • Which files were updated.
  • Whether any files were excluded via .sync-exclude.
  • The final commit (git log -1 --oneline).

If the merge had conflicts, relay the conflict list and instruct the user to resolve manually.

Important Notes

  • The script protects personal files (Meetings, Teams, Templates, etc.) via .gitattributes merge=ours rules.
  • Files matching patterns in .sync-exclude are auto-removed from the merge (e.g. upstream example files).
  • This skill never pushes — the user decides when to push.
  • If the upstream remote doesn't exist, do not create it automatically — prompt the user for the URL.

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

Fetch & embed AI transcripts as Obsidian callouts. Args: <path>, all, refresh <path>. Prompts for URLs if empty.

The English summary is being prepared. Showing the original description.

benoror/obsidianos_work165Updated Jun 11, 2026

commit

Free

Stage and commit with flexible intent parsing. Accepts file/folder scope, free-text description, amend, or any combination.

The English summary is being prepared. Showing the original description.

benoror/obsidianos_work165Updated Jun 11, 2026

Extract clean markdown content from web pages using Defuddle CLI, removing clutter and navigation to save tokens. Use instead of WebFetch when the user provides a URL to read or analyze, for online documentation, articles, blog posts, or any standard web page.

The English summary is being prepared. Showing the original description.

benoror/obsidianos_work165Updated Jun 11, 2026

Resolve and fill Participants frontmatter + link unlinked names in body. Args: <path>, all.

The English summary is being prepared. Showing the original description.

benoror/obsidianos_work165Updated Jun 11, 2026

Extract action items as plain markdown bullets (with confirmation). Args: <path>. No args = run [/note-status pending --step=todos](../note-status/SKILL.md#pending-mode).

The English summary is being prepared. Showing the original description.

benoror/obsidianos_work165Updated Jun 11, 2026

Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.

The English summary is being prepared. Showing the original description.

benoror/obsidianos_work165Updated Jun 11, 2026

See all skills by benoror

Report a problem with this skill