skills-sync CLI

Lightweight POSIX synchronization engine for cross-repository agent skill workflows

Quick install:curl -fsSL https://raw.githubusercontent.com/MishraShardendu22/agent-skills/main/scripts/install.sh | bash

Architecture

Central Hub

MishraShardendu22/agent-skills

Canonical repository of 20 verified agent skills, schema validator, CI workflows, and release tags.

Enforces SKILL.md specification

Sync Engine

skills-sync CLI

Standalone portable bash script with zero external runtime dependencies. Executes git-level synchronization and branch creation.

Bidirectional pull & push

Downstream Spokes

Local Repositories

Run skills-sync pull in any repository to equip coding agents with standardized team runbooks.

Stored in .agents/skills/

Installation Methods

1. Run the one-line installer

Installs binary to ~/.local/bin/skills-sync and ensures executable permissions.

curl -fsSL https://raw.githubusercontent.com/MishraShardendu22/agent-skills/main/scripts/install.sh | bash

2. Ensure ~/.local/bin is in PATH

export PATH="$HOME/.local/bin:$PATH"

Command Reference

skills-sync pull

Read / Upstream

Fetches and updates all skills from the upstream hub into your local .agents/skills/ directory.

Execution Details:

Auto-detects repository root and locates .agents/skills/ or skills/ directory.
Performs a shallow depth-1 clone of upstream to keep bandwidth minimal.
Safely updates incoming skills without clobbering untracked project files.

Terminal Output:

[INFO] Synchronizing skills from upstream: MishraShardendu22/agent-skills (main)
[INFO] Fetching remote skill catalog...
[SUCCESS] Successfully pulled and updated 20 skills into /workspace/.agents/skills

Environment Variables

VARIABLE	DEFAULT	DESCRIPTION
AGENT_SKILLS_REPO	MishraShardendu22/agent-skills	The upstream central GitHub repository where skills are pulled from and pushed to.
AGENT_SKILLS_BRANCH	main	Target git branch for upstream pull/push operations.
GITHUB_TOKEN	(optional)	GitHub Personal Access Token for authenticated clones or automated CI PR creation.
AGENT_SKILLS_DIR	Auto-detected (.agents/skills)	Override path where local skills are populated on the host filesystem.

Automate Upstream Sync via GitHub Actions

Add to .github/workflows/sync-skills-upstream.yml in any downstream project.

name: Sync Skills Upstream

on:
  push:
    branches: [ main ]
    paths: [ '.agents/skills/**', 'skills/**' ]
  workflow_dispatch:

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Push Skills Upstream to Hub
        env:
          AGENT_SKILLS_REPO: "MishraShardendu22/agent-skills"
          GITHUB_TOKEN: ${{ secrets.SKILLS_SYNC_TOKEN || secrets.GITHUB_TOKEN }}
        run: |
          curl -fsSL https://raw.githubusercontent.com/MishraShardendu22/agent-skills/main/scripts/skills-sync.sh | bash -s -- push