push
The push skill automates Git workflows by staging all vault changes, generating meaningful commit messages either from user input or automatic summaries, and syncing with remote repositories. Use this after making note modifications or at day's end to save progress with contextual commit information that tracks which files were added, modified, or deleted.
git clone --depth 1 https://github.com/ballred/obsidian-claude-pkm /tmp/push && cp -r /tmp/push/vault-template/.claude/skills/push ~/.claude/skills/pushSKILL.md
# 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
Analyze alignment between daily activities and long-term goals. Identify gaps, over/under-investment, and suggest rebalancing. Use for goal audits and priority checks.
Process inbox items using GTD principles. Categorize, clarify, and organize captured notes into actionable items. Use for inbox zero and capture processing.
Organize and restructure vault notes. Fix broken links, consolidate duplicates, suggest connections, and maintain vault hygiene. Use when managing vault organization or cleaning up notes.
Facilitate comprehensive weekly review process. Analyze past week's daily notes, calculate goal progress, and help plan next week. Use for Sunday/Monday weekly reviews.
Scaffold the PKM system onto an existing Obsidian vault. Scans your vault structure, maps folders interactively, and generates configuration — no template required.
Find broken wiki-links in the vault. Read-only analysis — scans for [[links]] and verifies target files exist. No writes, no dependencies.
Create daily notes and manage morning, midday, and evening routines. Structure daily planning, task review, and end-of-day reflection. Use for daily productivity routines or when asked to create today's note.
Track progress toward 3-year, yearly, monthly, and weekly goals. Calculate completion percentages, surface stalled goals, connect daily tasks to objectives. Use for goal reviews and progress tracking.