pss-usage

# PSS Usage Skill

## Purpose

This skill teaches you how to:
- Use PSS (Perfect Skill Suggester) commands
- Interpret skill suggestion output
- Understand confidence levels and evidence types
- Troubleshoot common PSS issues
- Maintain the skill index

## When to Use This Skill

**Activate this skill when:**
- User asks about skill suggestions ("which skills should I use?")
- User asks about PSS functionality ("how does skill suggestion work?")
- User requests reindexing ("update the skill index", "refresh skills")
- User asks for PSS status ("is PSS working?", "show me PSS info")
- Skill suggestions appear empty or incorrect
- PSS commands fail or produce errors

**Do NOT activate for:**
- General skill activation (use skill-specific skills instead)
- Writing skill content (use skill authoring skills instead)
- Plugin development (use plugin development skills instead)

---

## Quick Reference

### Most Common Tasks

| Task | Command | When to Use |
|------|---------|-------------|
| **Check PSS health** | `/pss-status` | Before first use, after installing skills, when debugging issues |
| **Rebuild skill index** | `/pss-reindex-skills` | After adding/modifying skills, when suggestions are stale |
| **Understand suggestion** | Read confidence + evidence | Every time PSS suggests skills |

### Command Quick Examples

**Check if PSS is working:**
```
/pss-status
```

Expected output:
```
Perfect Skill Suggester Status
==============================
Index Status: ✓ Exists
Total Skills Indexed: 42
```

**Rebuild the index after adding skills:**
```
/pss-reindex-skills
```

Expected output:
```
Reindexing skills...
✓ Index updated successfully
```

---

## Detailed Command Reference

For comprehensive information about all PSS commands, see [pss-commands.md](references/pss-commands.md):

### Contents of pss-commands.md

- **1.0 Understanding PSS command structure and invocation**
  - 1.1 Command naming conventions
  - 1.2 Command invocation from Claude Code chat

- **2