# SuperBackend Skills Plugin for SuperCLI

This plugin loads SuperBackend SKILL.md files into the SuperCLI skills catalog.

## Installation

```bash
supercli plugins install /path/to/saas-backend/plugins/supercli
```

## Features

- **Auto-discovery**: Automatically finds all SKILL.md files in the `skills/` directory
- **No registry required**: Works as a local plugin
- **Live sync**: Changes to skill files are picked up immediately with `supercli skills sync`

## Usage

### List Available Skills

```bash
supercli skills list --catalog --json
```

### Get a Specific Skill

```bash
supercli skills get superbackend:auth-github-skill --json
```

### Learn About the Plugin

```bash
supercli plugins learn superbackend
```

### Sync Skills Catalog

After editing SKILL.md files, refresh the catalog:

```bash
supercli skills sync
```

## Adding New Skills

1. Create a new directory under `skills/`:
   ```bash
   mkdir -p skills/auth-email
   ```

2. Add your SKILL.md file:
   ```bash
   cp /path/to/.agents/skills/auth-email/SKILL.md skills/auth-email/
   ```

3. Sync the catalog:
   ```bash
   supercli skills sync
   ```

4. Verify the skill is available:
   ```bash
   supercli skills list --catalog --json | grep auth-email
   ```

## Skill File Format

Each skill is a markdown file with YAML frontmatter:

```markdown
---
skill_name: my-skill-name
description: Brief description of the skill
tags: tag1,tag2,tag3
---

# Skill Content

Detailed documentation...
```

## Troubleshooting

### Skill Not Found After Adding

Run sync to refresh the catalog:
```bash
supercli skills sync --json
```

### Check Plugin Status

```bash
supercli plugins show superbackend --json
```

### View Skills Index

```bash
cat ~/.supercli/skills-index.json | jq '.skills[] | select(.provider=="superbackend")'
```

## Uninstall

```bash
supercli plugins remove superbackend
```