Skip to content

README.md

Latest commit

 

History

History
249 lines (180 loc) · 10.9 KB

README.md

File metadata and controls

249 lines (180 loc) · 10.9 KB
Raw

Autonomous AI Agent Skills Catalog

Production-Grade Skills, Guardrails & Workflows for Antigravity, Claude, Jules, Cursor & AI Engineers

MIT License Skills Count Agent Runtimes Validation CI Sync Engine

A library of autonomous AI agent skills, deterministic runbooks, pre-commit reflexes, and safety protocols with zero-friction bi-directional cross-repository synchronization.

Table of Contents

Overview

When building applications with AI coding agents (such as Google Antigravity, Google Jules CLI, Claude Code, or Cursor), standard prompts frequently suffer from context drift, forgotten pre-commit checks, fragmented branch management, and conversational filler.

This repository provides 18 modular, tested agent skills following the open SKILL.md specification. Each skill defines:

  1. Trigger Semantics: YAML frontmatter describing precise activation conditions.
  2. Explicit Safety Directives: Alerts ([!IMPORTANT], [!WARNING]) enforcing non-negotiable boundaries.
  3. Deterministic Runbooks: Shell-verified commands and code recipes.
  4. Autonomous Convergence: Self-verification tests and linters for independent execution.

Architecture & Hub-and-Spoke Sync

All skills are maintained centrally in this repository (Hub). Downstream development projects (Spokes) can pull skills or push newly authored skills back to the hub using the portable skills-sync engine.

flowchart TD
    subgraph Hub["Central Hub: MishraShardendu22/agent-skills"]
        MasterSkills[".agents/skills/ (18 Modular Skills)"]
        Validator["CI Schema Validator (validate-skills.py)"]
    end

    subgraph Repo1["Project: github-backup-automation-system"]
        P1Skills[".agents/skills/"]
    end

    subgraph Repo2["Project: Downstream-Repository-A"]
        P2Skills[".agents/skills/"]
    end

    subgraph Repo3["Project: Downstream-Repository-B"]
        P3Skills[".agents/skills/"]
    end

    MasterSkills -- "skills-sync pull" --> P1Skills
    MasterSkills -- "skills-sync pull" --> P2Skills
    MasterSkills -- "skills-sync pull" --> P3Skills

    P1Skills -. "skills-sync push (new skills)" .-> MasterSkills
    P2Skills -. "skills-sync push (new skills)" .-> MasterSkills
    P3Skills -. "skills-sync push (new skills)" .-> MasterSkills
Loading

Quick Start & Installation

1. One-Line Global CLI Install

Install the portable skills-sync CLI directly into ~/.local/bin:

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

2. Pull Skills into Any Project

Navigate to any git repository and run:

skills-sync pull

This populates .agents/skills/ with the entire catalog.

Master Skills Catalog

1. Communication Standards & Core Protocols

Skill Description Direct Link
professional-communication-standard Enforces strictly emoji-free, concise, objective, and technically rigorous responses without fluff or conversational preambles. .agents/skills/professional-communication-standard

2. Autonomous Git & Version Control

Skill Description Direct Link
git-branch-management Rules and procedures for creating, naming, structuring, and navigating Git branches. .agents/skills/git-branch-management
git-commit-workflow Commit design taxonomy, semantic commit formatting, and mandatory GPG signing. .agents/skills/git-commit-workflow
pull-request-management Runbooks for authoring and managing clean PRs targeting main with PR consolidation. .agents/skills/pull-request-management
github-pr-issue-automation Auto-assignment, conventional label categorization, and GitHub markdown standards. .agents/skills/github-pr-issue-automation
git-post-merge-cleanup Post-merge branch synchronization, stale branch pruning, and repository garbage collection. .agents/skills/git-post-merge-cleanup

3. AI Engineering & Autonomous Review

Skill Description Direct Link
jules-ai-engineering-workflow Autonomous Jules AI review loop across 38 architectural dimensions for Tech Lead delegation. .agents/skills/jules-ai-engineering-workflow
agent-observatory-workflow LangChain tool-calling, Tool-Calling RAG workflows, pgvector search, and HITL protocols. .agents/skills/agent-observatory-workflow
doc-synchronization Autonomous synchronization of documentation, changelogs, and skills without human prompting. .agents/skills/doc-synchronization

4. DevOps, Tooling & CI/CD Pipelines

Skill Description Direct Link
ci-cd-workflow Multi-environment CI/CD workflows, Docker Hub publishing, Render & Vercel deployments. .agents/skills/ci-cd-workflow
cli-tooling-guide Standard operating guide for authenticated CLI tools (gh, jules, vercel, neonctl, docker). .agents/skills/cli-tooling-guide
precommit-workflow-management Maintain, configure, and execute intelligent multi-language pre-commit hook suites. .agents/skills/precommit-workflow-management

5. Code Quality, Testing & Simplification

Skill Description Direct Link
code-quality-and-validation Standards, formatters, linters, and static type checking for Go, Python, and TypeScript. .agents/skills/code-quality-and-validation
codebase-simplification-guide Architecture minimalism, dead code elimination, and abstraction reduction. .agents/skills/codebase-simplification-guide
test-creation-and-execution Multi-layer test creation, mocks, integration testing, and agent eval test suites. .agents/skills/test-creation-and-execution
repository-maintenance Database integrity, idempotent migrations, backup verification, and dependency management. .agents/skills/repository-maintenance

6. System Architecture & SaaS Systems

Skill Description Direct Link
saas-and-mcp-architecture SaaS Connector Hub, encrypted secret vaults, cloud storage, and MCP tool expansions. .agents/skills/saas-and-mcp-architecture
github-backup-architecture Multi-service architecture, pgvector hybrid search, and cloud deployment boundaries. .agents/skills/github-backup-architecture

Using skills-sync CLI

The skills-sync tool provides an interface for managing skills across any local repository:

# Pull latest skills from upstream hub into .agents/skills/
skills-sync pull

# List installed skills with descriptions
skills-sync list

# Scaffold a new skill template
skills-sync new database-auto-sync

# Validate all SKILL.md files for schema compliance
skills-sync validate

# Push a new skill back to the central hub
skills-sync push database-auto-sync

# Bidirectional sync (pull updates, push new local skills)
skills-sync sync

Automating Cross-Repo Sync via GitHub Actions

To make any project automatically push new or modified skills back to MishraShardendu22/agent-skills, add .github/workflows/sync-skills-upstream.yml to your downstream repository:

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

Creating a New Skill

To author a new skill:

  1. Run skills-sync new <skill-name>
  2. Follow the standard template structure: 
    ---
name: my-new-skill
description: >-
  When to use this skill and what high-level workflows it accomplishes.
---

# My New Skill Title

## 1. Overview
...

## 2. Core Directives & Rules
...

## 3. Step-by-Step Procedure
...
  3. Run skills-sync validate to check syntax.
  4. Run skills-sync push my-new-skill to contribute it back.

Contributing

Contributions are welcomed. Please read CONTRIBUTING.md for details on code of conduct, skill validation requirements, and pull request process.

License

This project is open source and available under the MIT License. Copyright (c) 2026 Shardendu Mishra.