# SynthOperator AI Skills Pack

A high-performance library and distribution hub for 2662+ specialized AI agent skills, organized into departments for streamlined access and deployment.

## Project Overview

SynthOperator AI Skills Pack is a central repository and management system for AI agent "skills". Each skill is a self-contained unit consisting of logic, prompts, and metadata designed to extend the capabilities of AI agents in specific domains like Executive Strategy, SEO, Software Engineering, and more.

The project provides a **Command Center** dashboard—a web-based interface for searching, browsing, and downloading these skills as ZIP packages.

### Key Technologies
- **Server:** Node.js with Express.
- **Frontend:** Vanilla HTML/CSS/JS (served as a static dashboard).
- **Indexing:** Python script (`build_vault.py`) for automated database generation.
- **Compression:** `archiver` package for dynamic ZIP generation of skill folders.
- **Typography:** JetBrains Mono and Syne fonts for a "cyber-industrial" aesthetic.

## Architecture

```text
ETSY_AGENT_SKILLS_PACK/
├── 01_EXECUTIVE_AND_STRATEGY/ # Department folders containing individual skills
│   └── ceo-advisor/
│       └── SKILL.md           # Mandatory skill definition file
├── js/
│   └── vault.js               # Auto-generated database of all indexed skills
├── server.js                  # Express server for the dashboard and API
├── build_vault.py             # Indexer script that parses SKILL.md files
├── Command_Center.html        # Main dashboard interface
└── START_SYSTEM.bat           # Windows entry point script
```

## Getting Started

### Prerequisites
- [Node.js](https://nodejs.org/) installed.
- [Python 3.x](https://www.python.org/) installed.

### Installation & Execution
1.  **Install Dependencies:**
    ```bash
    npm install
    ```
2.  **Rebuild Skill Index (Optional):**
    If you add or modify skills, update the database:
    ```bash
    python build_vault.py
    ```
3.  **Start the Command Center:**
    On Windows, run:
    ```cmd
    START_SYSTEM.bat
    ```
    Or manually:
    ```bash
    node server.js
    ```
4.  **Access:**
    Open [http://localhost:3000](http://localhost:3000) in your browser.

## Development Conventions

### Adding a New Skill
1.  Navigate to the appropriate department directory (e.g., `08_SOFTWARE_ENGINEERING`).
2.  Create a new folder for the skill (slug-style-naming).
3.  Add a `SKILL.md` file. It **MUST** include YAML frontmatter or a clear header for the indexer to parse:
    ```markdown
    ---
    name: "My New Skill"
    description: "Detailed description of what the skill does."
    ---
    # My New Skill
    ...
    ```
4.  Run `python build_vault.py` to include the new skill in the dashboard.

### Coding Style
- **Backend:** CommonJS (Node.js). Keep `server.js` lean; focus on serving static assets and handling the download API.
- **Frontend:** No build step (Post-CSS/Tailwind). Styles are embedded in `Command_Center.html` or located in `js/`.
- **Naming:** Follow numbered directory conventions (e.g., `01_...`, `02_...`) for departments to maintain sorting.

## Deployment API
- `GET /`: Serves the Command Center dashboard.
- `GET /api/download?skill=path/to/folder`: Dynamically bundles the requested skill folder into a `.zip` and initiates a download.