Agent skill

Sync Upstream Obsidianos

by benoror in benoror/obsidianos_work

Pull structural updates from upstream ObsidianOS into the local vault.

MITAuto-check passedDevelopment

Install Sync Upstream Obsidianos

skills CLI
$ npx skills add benoror/obsidianos_work --skill sync-upstream-obsidianos -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install benoror/obsidianos_work sync-upstream-obsidianos --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/benoror/obsidianos_work.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/sync-upstream-obsidianos .claude/skills/sync-upstream-obsidianos && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sync-upstream-obsidianos
GitHub stars
165
Token cost
~465 tokens
SKILL.md length
220 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Pull structural updates from upstream ObsidianOS into the local vault.

  • Works in 4 steps: Check prerequisites → Preview → Confirm and merge → …
  • Development work in your project
  • SKILL.md covers Usage, Workflow and Important Notes
  • Calls git

What it does

Sync Upstream Obsidianos is an agent skill from benoror/obsidianos_work. Pull structural updates from upstream ObsidianOS into the local vault.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Git. The repository describes itself as: ObsidianOS - Work Vault. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/sync-upstream-obsidianos”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Check prerequisites
  2. Preview
  3. Confirm and merge
  4. Report results

What it can do on your machine

Read from SKILL.md and the folder at commit 3c7923e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sync Upstream Obsidianos loads about 465 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 220 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~465

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from benoror/obsidianos_work at commit 3c7923e, republished under its MIT licence (© benoror). 220 words, ~465 tokens.

Download SKILL.mdSave it as .claude/skills/sync-upstream-obsidianos/SKILL.md (or your agent's skills folder).
name
sync-upstream-obsidianos
description
Pull structural updates from upstream ObsidianOS into the local vault.
license
MIT

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.

© benoror, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/sync-upstream-obsidianos of benoror/obsidianos_work.

Open the folder on GitHubat commit 3c7923e

Compare with similar skills

Sync Upstream Obsidianos next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sync Upstream Obsidianos compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sync Upstream Obsidianos this skillbenoror/obsidianos_work165—~465Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Finishing A Development Branchfarm-fe/farm5.6k34 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 34 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed

More from benoror/obsidianos_work

All 18 skills in this repo
  • Qmd

    benoror/obsidianos_work

    Search vault notes by keyword or meaning. An agent skill from benoror/obsidianos_work.

    165 GitHub stars~858 tokensUpdated 4 mo ago
    Auto-check passed
  • Cache Notes

    benoror/obsidianos_work

    Fetch & embed AI transcripts as Obsidian callouts. An agent skill from benoror/obsidianos_work.

    165 GitHub stars~2.7k tokensUpdated 4 mo ago
    Auto-check passed
  • Fill Participants

    benoror/obsidianos_work

    Resolve and fill Participants frontmatter + link unlinked names in body.

    165 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Followup Todos

    benoror/obsidianos_work

    Extract action items as plain markdown bullets (with confirmation).

    165 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • Last 1on1

    benoror/obsidianos_work

    Show when you last had a 1:1 with each direct report / peer, sorted by recency.

    165 GitHub stars~732 tokensUpdated 4 mo ago
    Auto-check passed
  • Mail Transcripts

    benoror/obsidianos_work

    Gmail AI transcript notifications → meeting Notes: URLs + mark read.

    165 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Sync Upstream Obsidianos

What does Sync Upstream Obsidianos do?

Pull structural updates from upstream ObsidianOS into the local vault. Sync Upstream Obsidianos is an agent skill from benoror/obsidianos_work. Pull structural updates from upstream ObsidianOS into the local vault.

When should I use Sync Upstream Obsidianos?

Sync Upstream Obsidianos fits situations like: development work in your project.

How do I install Sync Upstream Obsidianos in Claude Code?

Run `npx skills add benoror/obsidianos_work --skill sync-upstream-obsidianos -a claude-code`. Or copy the skill folder (.agents/skills/sync-upstream-obsidianos in benoror/obsidianos_work) into .claude/skills/sync-upstream-obsidianos in your project. Claude Code loads it when a task matches its description.

How do I install Sync Upstream Obsidianos in Codex?

Run `npx skills add benoror/obsidianos_work --skill sync-upstream-obsidianos -a codex`. Or copy the skill folder (.agents/skills/sync-upstream-obsidianos in benoror/obsidianos_work) into .agents/skills/sync-upstream-obsidianos in your project. Codex loads it when a task matches its description.

Can I use Sync Upstream Obsidianos in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add benoror/obsidianos_work --skill sync-upstream-obsidianos -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sync-upstream-obsidianos, .gemini/skills/sync-upstream-obsidianos, .github/skills/sync-upstream-obsidianos and .opencode/skills/sync-upstream-obsidianos in your project.

What does Sync Upstream Obsidianos need to run?

Going by SKILL.md and its folder, Sync Upstream Obsidianos needs the command-line tools its instructions call (git).

Does Sync Upstream Obsidianos access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Sync Upstream Obsidianos safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sync Upstream Obsidianos use?

Sync Upstream Obsidianos is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sync Upstream Obsidianos use?

About 465 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sync Upstream Obsidianos?

Skills that share tags, products or a category with Sync Upstream Obsidianos: Finishing a Development Branch (obra/superpowers, 297k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars) and Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sync Upstream Obsidianos?

benoror (a GitHub user) maintains it in benoror/obsidianos_work, which has 165 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on June 11, 2026.

Source: benoror/obsidianos_work on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.