skills.rest
unclehowell
unclehowellCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

brain-sync

Archive session learnings and synchronize the brain repository to GitHub.

Updated Sep 1, 2021
Search Tags:#automation#git#collaboration#sync#brain#watcher
One-click install
npx skills add https://github.com/unclehowell/unclehowell --skill brain-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brain-sync
Source: https://github.com/unclehowell/unclehowell/tree/main/skills/brain-sync
Command: npx skills add https://github.com/unclehowell/unclehowell --skill brain-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, inotifywait, gh.

What problem does it solve?

Keeps the collective brain up‑to‑date by automatically archiving session learnings and synchronizing changes to the shared GitHub repository, eliminating manual commit and push steps.

Core Features & Use Cases

  • On‑change watcher that monitors the brain directory and commits + pushes changes within seconds.
  • Manual and direct‑git fallback methods for environments where the watcher isn’t running.
  • Cross‑machine coordination ensuring all devices stay in sync through a central GitHub hub.
  • Conflict handling with automatic rebase‑retry loops for concurrent edits.

Quick Start

Use the brain-sync skill to archive today’s session notes and push the updates to the repository.

Frequently Asked Questions about brain-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically sync a local brain directory to a GitHub repository?▼

To sync a brain directory to GitHub automatically, an inotifywait-based watcher monitors directory changes and commits and pushes updates to the remote repository within seconds.

What is the best way to handle Git conflicts when syncing files across multiple machines?▼

Handling Git conflicts during cross-machine sync is managed through automatic rebase-retry loops that resolve concurrent edits and keep all devices coordinated through the central GitHub hub.

Do I need inotifywait to push session learnings to GitHub?▼

You do not need inotifywait to push session learnings if the watcher is not running, because the system provides a manual direct-git fallback sync.sh script to archive notes and push updates.

How does auto-archiving session learnings work with Git?▼

Auto-archiving session learnings with Git works by detecting when agents complete non-trivial tasks that generate new information, automatically committing those updates, and pushing changes to the GitHub remote.

What are the limitations of using an inotifywait watcher for cross-machine collaboration?▼

A limitation of using an inotifywait watcher for cross-machine collaboration is that it requires appropriate Git credentials for push operations and a running environment, otherwise the fallback sync.sh must be used.

Related Skills

Explore More Software Engineering Skills→
twikustwikus
3

sync-with-claude

Synchronize local ~/.claude configuration folders to the repository with rsync --delete.

Community
Intermediate
motlinmotlin
14

git-workflow

Standardize git commits, rebasing, conflict resolution, and branch management.

Community
Basic
joshmandersjoshmanders
29

github

Automate GitHub issues, PRs, and project boards using the gh CLI.

Community
Advanced
brianpunzalanbrianpunzalan

speckit-git-commit

Auto-commit Speckit workflow changes after configured Spec Kit hooks.

Community
Intermediate