# Workhuman Skill Pack

> 18 production-ready Claude Code skills for Workhuman -- real Social Recognition API code for nominations, rewards, and HRIS integration.

## What This Is

A complete skill pack for integrating Workhuman Social Recognition. Every skill contains real API code: OAuth authentication, recognition nominations, reward catalog, employee sync, and HRIS integration patterns. Built for HR tech teams building recognition workflows.

## Installation

```bash
/plugin install workhuman-pack@claude-code-plugins-plus
```

## Skills

### Standard Skills (S01-S12)

| # | Skill | What It Does |
|---|-------|-------------|
| S01 | `workhuman-install-auth` | OAuth 2.0 client credentials, token management, connection test |
| S02 | `workhuman-hello-world` | Create recognition, list recent, check status, browse rewards |
| S03 | `workhuman-local-dev-loop` | Mock API responses, test fixtures, environment separation |
| S04 | `workhuman-sdk-patterns` | Typed client wrapper, token refresh, error normalization |
| S05 | `workhuman-core-workflow-a` | Recognition nominations, approval workflows, bulk creation |
| S06 | `workhuman-core-workflow-b` | Reward redemption, catalog browsing, points management |
| S07 | `workhuman-common-errors` | Auth failures, validation errors, budget limits |
| S08 | `workhuman-debug-bundle` | API diagnostics, token validation, endpoint health |
| S09 | `workhuman-rate-limits` | Request throttling, bulk operation limits |
| S10 | `workhuman-security-basics` | OAuth token security, HRIS data protection |
| S11 | `workhuman-prod-checklist` | HRIS sync validation, recognition flow testing |
| S12 | `workhuman-upgrade-migration` | API version changes, OAuth flow updates |

### Pro Skills (P13-P18)

| # | Skill | What It Does |
|---|-------|-------------|
| P13 | `workhuman-ci-integration` | Automated API tests, recognition flow validation |
| P14 | `workhuman-deploy-integration` | Deploy recognition bots to Teams/Slack |
| P15 | `workhuman-webhooks-events` | Recognition events, approval notifications |
| P16 | `workhuman-performance-tuning` | Bulk nominations, caching employee data |
| P17 | `workhuman-cost-tuning` | Points budget management, award level optimization |
| P18 | `workhuman-reference-architecture` | Recognition service, HRIS sync, notification pipeline |

## Key Concepts

- **Auth**: OAuth 2.0 client credentials
- **Recognition**: Peer-to-peer nominations with points and company values
- **Awards**: Bronze, Silver, Gold, Platinum levels
- **Rewards**: Points-based catalog (gift cards, merchandise, experiences)
- **HRIS**: Bidirectional sync with Workday, SAP, ADP
- **Integrations**: Microsoft Teams, Slack, Outlook

## License

MIT
