New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Push

by ballred in ballred/obsidian-claude-pkm

Commit and push vault changes to Git with smart commit messages.

MITAuto-check: notesDevelopment

Install Push

skills CLI
$ npx skills add ballred/obsidian-claude-pkm --skill push -a claude-code

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

GitHub CLI
$ gh skill install ballred/obsidian-claude-pkm push --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/ballred/obsidian-claude-pkm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/vault-template/.claude/skills/push .claude/skills/push && 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
push
GitHub stars
1.9k
Used in
1 other repo
Token cost
~745 tokens
SKILL.md length
249 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Commit and push vault changes to Git with smart commit messages.

  • Works in 3 steps: Stages All Changes → Creates Smart Commit Message → Syncs with Remote
  • Tasks that involve Commit messages
  • SKILL.md covers Usage, What This Skill Does, Commit Message Format and Workflow Integration, plus 5 more sections
  • Calls git

What it does

Push is an agent skill from ballred/obsidian-claude-pkm. Commit and push vault changes to Git with smart commit messages. Auto-stages files, creates meaningful commits, and syncs with remote. Use after making vault changes or at end of day.

Its SKILL.md is about 750 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, covering Commit messages and Git workflow. It works with Git. The repository describes itself as: A complete starter kit for an Obsidian + Claude Code personal knowledge management system. The licence is MIT.

When your agent uses it

  • Tasks that involve Commit messages
  • Tasks that involve Git workflow

Example prompts

  • “/push”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Glob

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Stages All Changes
  2. Creates Smart Commit Message
  3. Syncs with Remote

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Glob

    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

Push loads about 745 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 249 words of instructions outside code blocks.

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

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

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:116
    .env
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Glob

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 ballred/obsidian-claude-pkm at commit ef1e4da, republished under its MIT licence (© ballred). 249 words, ~745 tokens.

Download SKILL.mdSave it as .claude/skills/push/SKILL.md (or your agent's skills folder).
name
push
description
Commit and push vault changes to Git with smart commit messages. Auto-stages files, creates meaningful commits, and syncs with remote. Use after making vault changes or at end of day.
allowed-tools
Bash, Read, Glob
model
sonnet
disable-model-invocation
true
user-invocable
true

Git Push Skill

Automates Git workflow to save your notes with meaningful commit messages and push to remote repository.

Usage

Invoke with /push or ask Claude to save/commit your changes.

Basic Usage
/push
With Custom Message
/push "Completed project planning"

What This Skill Does

  1. Stages All Changes

    • Adds all modified files
    • Includes new files
    • Removes deleted files

  2. Creates Smart Commit Message

    • Uses provided message, or
    • Auto-generates from changes
    • Includes date/time stamp
    • Summarizes key modifications

  3. Syncs with Remote

    • Pulls latest changes (if enabled)
    • Pushes to remote repository
    • Handles merge conflicts gracefully

Commit Message Format

Automatic Messages

Based on your changes:

Daily note for 2024-01-15 + 3 project updates
- Added: Daily Notes/2024-01-15.md
- Modified: Projects/Learning Spanish/notes.md
- Modified: Goals/2. Monthly Goals.md
With Timestamp
[2024-01-15 09:30] Completed weekly review

Workflow Integration

Morning Routine
/daily          # Create daily note
# ... work on notes ...
/push "Morning planning complete"
End of Day
# Complete daily reflection
/push           # Auto-message with summary
After Weekly Review
/weekly         # Run weekly review
/push "Weekly review - Week 3"

Git Operations

Standard Flow
  1. git add . - Stage all changes
  2. git commit -m "message" - Create commit
  3. git pull --rebase origin main - Get remote changes
  4. git push origin main - Push to remote
Safety Checks
  • Verify Git repository exists
  • Check for uncommitted changes
  • Ensure remote is configured
  • Validate branch exists

Conflict Handling

If conflicts occur:

  1. Auto-resolve attempts (favor local for notes)
  2. If manual resolution needed, guide through process
  3. Never force push without explicit request

Security Considerations

Never Commit
  • Passwords or credentials
  • API keys
  • Personal identification
  • Financial information
Use .gitignore for
private/
credentials.md
.env
.obsidian/workspace*
.obsidian/cache
.trash/
.DS_Store

Troubleshooting

Push Rejected?

Pull first, then push again:

bash
git pull --rebase origin main
git push origin main
Not a Git Repository?
bash
git init
git remote add origin [URL]
Large Files Issue?

Consider Git LFS for images/attachments.

Integration

Works with:

  • /daily - Commit after creating daily note
  • /weekly - Commit after weekly review
  • /onboard - No git needed for context loading
  • Auto-commit hook for automatic saves

© ballred, 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 vault-template/.claude/skills/push of ballred/obsidian-claude-pkm.

Open the folder on GitHubat commit ef1e4da

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ballred/obsidian-claude-pkm, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Push 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.

Push compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Push this skillballred/obsidian-claude-pkm1.9k1 repos~745Automated safety check: NotesMIT
ToolJet Multi-Repo CommitToolJet/ToolJet41k—~1.3kAutomated safety check: PassAGPL-3.0
Git Workflow and Versioningaddyosmani/agent-skills102k2 repos~3.5kAutomated safety check: NotesMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Saleor Commit Workflowsaleor/saleor23k—~575Automated safety check: PassBSD-3-Clause
Emoji Commit ConventionsbaptisteArno/typebot.io11k—~424Automated safety check: PassCustom licence

Similar skills

  • ToolJet Multi-Repo Commit

    ToolJet/ToolJet

    Commits changes across ToolJet's root repo and its server/ee and frontend/ee submodules, writing messages from the diffs and updating submodule pointers in order.

    41k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed

  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    102k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes

  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed

  • Saleor Commit Workflow

    saleor/saleor

    Commits changes in the Saleor codebase and works through pre-commit hook failures from ruff, mypy, the GraphQL schema check and the migrations check.

    23k GitHub stars~575 tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Emoji Commit Conventions

    baptisteArno/typebot.io

    Sets the repository's convention for commit messages and pull request titles: one emoji prefix for the main intent, a concise title and clean follow-up commits.

    11k GitHub stars~424 tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    DevelopmentAuto-check: notes

More from ballred/obsidian-claude-pkm

All 13 skills in this repo

  • Daily Notes Workflow

    ballred/obsidian-claude-pkm

    Creates today's daily note in an Obsidian vault and guides morning, midday and evening routines for planning, task review and reflection.

    1.9k GitHub stars~2k tokensUpdated 7 mo ago
    Auto-check passed

  • Cascading Goal Tracker

    ballred/obsidian-claude-pkm

    Tracks three-year, yearly, monthly, and weekly goals in linked Markdown files, calculating completion percentages and flagging stalled goals.

    1.9k GitHub stars~1.5k tokensUpdated 7 mo ago
    Auto-check passed

  • Obsidian Vault Operations

    ballred/obsidian-claude-pkm

    Reads, creates and edits notes in an Obsidian vault while preserving wiki-links, YAML frontmatter, tags and template variables.

    1.9k GitHub stars~652 tokensUpdated 7 mo ago
    Auto-check passed

  • Obsidian Project Tracker

    ballred/obsidian-claude-pkm

    Creates, tracks and archives projects linked to yearly goals in an Obsidian vault, with a status dashboard and a CLAUDE.md context file for each project.

    1.9k GitHub stars~1.1k tokensUpdated 7 mo ago
    Auto-check: notes

  • Obsidian PKM Vault Upgrade

    ballred/obsidian-claude-pkm

    Updates an obsidian-claude-pkm vault's system files to the latest version, with a backup, per-file diff review and no changes to your own notes.

    1.9k GitHub stars~1.1k tokensUpdated 7 mo ago
    Auto-check: notes

  • Obsidian Vault Adoption

    ballred/obsidian-claude-pkm

    Scans an existing Obsidian vault, maps its folders to PKM roles with your confirmation and generates configuration for the Claude PKM system without a template.

    1.9k GitHub stars~2.6k tokensUpdated 7 mo ago
    Auto-check: notes

Works with

Categories

Questions about Push

What does Push do?

Commit and push vault changes to Git with smart commit messages. Push is an agent skill from ballred/obsidian-claude-pkm. Commit and push vault changes to Git with smart commit messages.

When should I use Push?

Push fits situations like: tasks that involve Commit messages; tasks that involve Git workflow.

How do I install Push in Claude Code?

Run `npx skills add ballred/obsidian-claude-pkm --skill push -a claude-code`. Or copy the skill folder (vault-template/.claude/skills/push in ballred/obsidian-claude-pkm) into .claude/skills/push in your project. Claude Code loads it when a task matches its description.

How do I install Push in Codex?

Run `npx skills add ballred/obsidian-claude-pkm --skill push -a codex`. Or copy the skill folder (vault-template/.claude/skills/push in ballred/obsidian-claude-pkm) into .agents/skills/push in your project. Codex loads it when a task matches its description.

Can I use Push 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 ballred/obsidian-claude-pkm --skill push -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/push, .gemini/skills/push, .github/skills/push and .opencode/skills/push in your project.

What does Push need to run?

Going by SKILL.md and its folder, Push needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Bash, Read, Glob.

Does Push 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 Push safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Push use?

Push is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Push use?

About 745 tokens (SKILL.md is roughly 3k 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 Push?

Skills that share tags, products or a category with Push: ToolJet Multi-Repo Commit (ToolJet/ToolJet, 41k stars), Git Workflow and Versioning (addyosmani/agent-skills, 102k stars), React Router Pull Request Creator (remix-run/react-router, 57k stars) and Saleor Commit Workflow (saleor/saleor, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Push?

ballred (a GitHub user) maintains it in ballred/obsidian-claude-pkm, which has 1,876 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on February 18, 2026.

Source: ballred/obsidian-claude-pkm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.