<div align="center">

<!-- Animated Typing Banner -->
<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=600&size=28&duration=3000&pause=1000&color=2E9EF7&center=true&vCenter=true&multiline=true&repeat=true&width=600&height=100&lines=Bash+Shell+Mastery;7+Agents+%7C+7+Skills;Claude+Code+Plugin" alt="Bash Shell Mastery" />

<br/>

<!-- Badge Row 1: Status Badges -->
[![Version](https://img.shields.io/badge/Version-2.0.0-blue?style=for-the-badge)](https://github.com/pluginagentmarketplace/custom-plugin-bash-shell/releases)
[![License](https://img.shields.io/badge/License-Custom-yellow?style=for-the-badge)](LICENSE)
[![Status](https://img.shields.io/badge/Status-Production-brightgreen?style=for-the-badge)](#)
[![SASMP](https://img.shields.io/badge/SASMP-v1.3.0-blueviolet?style=for-the-badge)](#)

<!-- Badge Row 2: Content Badges -->
[![Agents](https://img.shields.io/badge/Agents-7-orange?style=flat-square&logo=robot)](#-agents)
[![Skills](https://img.shields.io/badge/Skills-7-purple?style=flat-square&logo=lightning)](#-skills)
[![Commands](https://img.shields.io/badge/Commands-8-green?style=flat-square&logo=terminal)](#-commands)

<br/>

<!-- Quick CTA Row -->
[📦 **Install Now**](#-quick-start) · [🤖 **Explore Agents**](#-agents) · [📖 **Documentation**](#-documentation) · [⭐ **Star this repo**](https://github.com/pluginagentmarketplace/custom-plugin-bash-shell)

---

### What is this?

> **Bash Shell Mastery** is a production-grade Claude Code plugin with **7 specialized agents** and **7 bonded skills** for mastering Bash shell scripting, automation, and command-line expertise.

</div>

---

## 📑 Table of Contents

<details>
<summary>Click to expand</summary>

- [Quick Start](#-quick-start)
- [Features](#-features)
- [Agents](#-agents)
- [Skills](#-skills)
- [Commands](#-commands)
- [Documentation](#-documentation)
- [Contributing](#-contributing)
- [License](#-license)

</details>

---

## 🚀 Quick Start

### Prerequisites

- Claude Code CLI v2.0.27+
- Active Claude subscription

### Installation (Choose One)

<details open>
<summary><strong>Option 1: From Marketplace (Recommended)</strong></summary>

```bash
# Step 1️⃣ Add the marketplace
/plugin marketplace add pluginagentmarketplace/custom-plugin-bash-shell

# Step 2️⃣ Install the plugin
/plugin install custom-plugin-bash-shell@pluginagentmarketplace-bash-shell

# Step 3️⃣ Restart Claude Code
# Close and reopen your terminal/IDE
```

</details>

<details>
<summary><strong>Option 2: Local Installation</strong></summary>

```bash
# Clone the repository
git clone https://github.com/pluginagentmarketplace/custom-plugin-bash-shell.git
cd custom-plugin-bash-shell

# Load locally
/plugin load .

# Restart Claude Code
```

</details>

### ✅ Verify Installation

After restart, you should see these agents:

```
custom-plugin-bash-shell:01-bash-fundamentals
custom-plugin-bash-shell:02-text-processing
custom-plugin-bash-shell:03-file-operations
custom-plugin-bash-shell:04-process-management
custom-plugin-bash-shell:05-networking
custom-plugin-bash-shell:06-automation
custom-plugin-bash-shell:07-shell-tools
```

---

## ✨ Features

| Feature | Description |
|---------|-------------|
| 🤖 **7 Agents** | Specialized AI agents for Bash shell mastery |
| 🛠️ **7 Skills** | Production-grade capabilities with PRIMARY_BOND |
| ⌨️ **8 Commands** | Quick slash commands for shell learning |
| 🔄 **SASMP v1.3.0** | Full protocol compliance with agent-skill bonding |
| 📋 **Input/Output Schemas** | Type-safe request/response patterns |
| 🛡️ **Error Handling** | Comprehensive fallback strategies |
| 🔧 **Troubleshooting** | Built-in debug guides and decision trees |

---

## 🤖 Agents

### 7 Specialized Bash Agents

| # | Agent | Purpose | Bonded Skill |
|---|-------|---------|--------------|
| 1 | **01-bash-fundamentals** | Variables, control flow, functions, error handling | `bash-basics` |
| 2 | **02-text-processing** | grep, sed, awk, regex mastery | `text-processing` |
| 3 | **03-file-operations** | Permissions, find, archives, rsync | `file-operations` |
| 4 | **04-process-management** | Jobs, signals, cron, systemd | `process-management` |
| 5 | **05-networking** | curl, ssh, DNS, port management | `shell-networking` |
| 6 | **06-automation** | CI/CD, makefiles, deployment scripts | `shell-automation` |
| 7 | **07-shell-tools** | jq, xargs, parallel, pipelines | `shell-tools` |

### Agent Features

Each agent includes:
- **Input/Output Schemas** - Type-safe parameter validation
- **Error Handling Patterns** - Graceful failure with fallback strategies
- **Troubleshooting Guides** - Decision trees for common issues
- **Code Examples** - Production-ready 2024-2025 best practices

---

## 🛠️ Skills

### 7 Production-Grade Skills

| Skill | Description | Difficulty |
|-------|-------------|------------|
| `bash-basics` | Variables, control structures, functions, arrays | Beginner |
| `text-processing` | grep, sed, awk essentials for data transformation | Intermediate |
| `file-operations` | chmod, find, tar, rsync for file management | Beginner |
| `process-management` | Signals, cron jobs, daemons, systemd services | Intermediate |
| `shell-networking` | curl, ssh, ports, DNS for network operations | Intermediate |
| `shell-automation` | Scripts, CI/CD, GitHub Actions, testing | Advanced |
| `shell-tools` | jq, xargs, parallel for advanced workflows | Advanced |

### Invoke Skills

```bash
# Example skill invocation
Skill("custom-plugin-bash-shell:bash-basics")
Skill("custom-plugin-bash-shell:text-processing")
Skill("custom-plugin-bash-shell:shell-automation")
```

---

## ⌨️ Commands

| Command | Description |
|---------|-------------|
| `/explore-roadmap` | Explore Bash learning roadmap |
| `/my-learning-path` | Get personalized Bash learning path |
| `/skill-assessment` | Assess your Bash skills |
| `/compare-roles` | Compare shell scripting roles |
| `/find-my-role` | Discover ideal shell scripting role |
| `/career-progression` | Plan your DevOps career growth |
| `/project-ideas` | Get hands-on Bash project ideas |
| `/interview-prep` | Prepare for shell scripting interviews |

---

## 📚 Documentation

| Document | Description |
|----------|-------------|
| [CHANGELOG.md](CHANGELOG.md) | Version history |
| [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute |
| [LICENSE](LICENSE) | License information |

---

## 📁 Project Structure

<details>
<summary>Click to expand</summary>

```
custom-plugin-bash-shell/
├── 📁 .claude-plugin/
│   ├── plugin.json          # Plugin configuration
│   └── marketplace.json     # Marketplace metadata
├── 📁 agents/                # 7 specialized agents
│   ├── 01-bash-fundamentals.md
│   ├── 02-text-processing.md
│   ├── 03-file-operations.md
│   ├── 04-process-management.md
│   ├── 05-networking.md
│   ├── 06-automation.md
│   └── 07-shell-tools.md
├── 📁 skills/                # 7 bonded skills
│   ├── bash-basics/
│   ├── text-processing/
│   ├── file-operations/
│   ├── process-management/
│   ├── shell-networking/
│   ├── shell-automation/
│   └── shell-tools/
├── 📁 commands/              # 8 slash commands
├── 📁 hooks/                 # Event hooks
├── 📄 README.md
├── 📄 CHANGELOG.md
├── 📄 CONTRIBUTING.md
└── 📄 LICENSE
```

</details>

---

## 📅 Metadata

| Field | Value |
|-------|-------|
| **Version** | 2.0.0 |
| **Last Updated** | 2025-12-30 |
| **Status** | Production Ready |
| **SASMP** | v1.3.0 |
| **Agents** | 7 |
| **Skills** | 7 |
| **Commands** | 8 |

---

## 🤝 Contributing

Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md).

1. Fork the repository
2. Create your feature branch
3. Follow SASMP v1.3.0 guidelines
4. Submit a pull request

---

## ⚠️ Security

> **Important:** This repository contains third-party code and dependencies.
>
> - ✅ Always review code before using in production
> - ✅ Check dependencies for known vulnerabilities
> - ✅ Follow security best practices
> - ✅ Report security issues privately via [Issues](../../issues)

---

## 📝 License

Copyright © 2025 **Dr. Umit Kacar** & **Muhsin Elcicek**

Custom License - See [LICENSE](LICENSE) for details.

---

## 👥 Contributors

<table>
<tr>
<td align="center">
<strong>Dr. Umit Kacar</strong><br/>
Senior AI Researcher & Engineer
</td>
<td align="center">
<strong>Muhsin Elcicek</strong><br/>
Senior Software Architect
</td>
</tr>
</table>

---

<div align="center">

**Made with ❤️ for the Claude Code Community**

[![GitHub](https://img.shields.io/badge/GitHub-pluginagentmarketplace-black?style=for-the-badge&logo=github)](https://github.com/pluginagentmarketplace)

</div>