Agent Skills Catalog/CLI Guide

skills-sync CLI

Lightweight POSIX synchronization engine for cross-repository agent skill workflows.

Browse Skills View Source

One-Line Global InstallPOSIX

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

Hub & Spoke Architecture

CENTRAL HUB

MishraShardendu22/agent-skills

Canonical upstream repository hosting 30 production agent skills, test suites, and automated release tags.

Enforces SKILL.md specification

SYNC ENGINE

skills-sync CLI

Portable bash script with zero external dependencies. Executes safe git-level synchronization and branch management.

Bidirectional pull & push

DOWNSTREAM SPOKES

Project Repositories

Run skills-sync pull in any repository to inject engineering standards into .agents/skills/.

Zero configuration required

Installation Methods

1. Run the one-line installer

Installs binary to ~/.local/bin/skills-sync and sets 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 & Terminal Engine

skills-sync ~ zsh (pull)

❯skills-sync pull

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

Operational Mechanics:

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

Simulated Terminal Output:

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

Environment Variables

VARIABLE	DEFAULT	DESCRIPTION
AGENT_SKILLS_REPO	MishraShardendu22/agent-skills	The central upstream 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 repository.

sync-skills-upstream.yml

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

Agent Skills Catalog/CLI Guide

skills-sync CLI

Lightweight POSIX synchronization engine for cross-repository agent skill workflows.

Browse Skills View Source

One-Line Global InstallPOSIX

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

Hub & Spoke Architecture

CENTRAL HUB

MishraShardendu22/agent-skills

Canonical upstream repository hosting 30 production agent skills, test suites, and automated release tags.

Enforces SKILL.md specification

SYNC ENGINE

skills-sync CLI

Portable bash script with zero external dependencies. Executes safe git-level synchronization and branch management.

Bidirectional pull & push

DOWNSTREAM SPOKES

Project Repositories

Run skills-sync pull in any repository to inject engineering standards into .agents/skills/.

Zero configuration required

Installation Methods

1. Run the one-line installer

Installs binary to ~/.local/bin/skills-sync and sets 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 & Terminal Engine

skills-sync ~ zsh (pull)

❯skills-sync pull

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

Operational Mechanics:

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

Simulated Terminal Output:

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

Environment Variables

VARIABLE	DEFAULT	DESCRIPTION
AGENT_SKILLS_REPO	MishraShardendu22/agent-skills	The central upstream 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 repository.

sync-skills-upstream.yml

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