Claude Code skill pack for Workhuman (18 skills)

18 plugin-local skills

MIT License

Claude Code Adapters (declared)

Installation

Open Claude Code and run this command:

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

Use --global to install for all projects, or --project for current project only.

What It Does

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

Skills (18) plugin-local skills

workhuman-ci-integration View full skill →

Workhuman ci integration for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-common-errors View full skill →

Workhuman common errors for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-core-workflow-a View full skill →

Workhuman core workflow a for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-core-workflow-b View full skill →

Workhuman core workflow b for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-cost-tuning View full skill →

Workhuman cost tuning for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-debug-bundle View full skill →

Workhuman debug bundle for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-deploy-integration View full skill →

Workhuman deploy integration for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-hello-world View full skill →

Workhuman hello world for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

Workhuman Hello World

Overview

Create a recognition nomination and list recent recognitions -- the two fundamental Workhuman API operations. Workhuman Social Recognition enables peer-to-peer and manager-to-employee recognition with points-based rewards.

Instructions

Step 1: List Recent Recognitions


const { data: recognitions } = await api.get('/api/v1/recognitions', {
  params: { limit: 10, sort: '-created_at' },
});

recognitions.data.forEach((rec: any) => {
  console.log(`${rec.nominator.name} recognized ${rec.recipient.name}`);
  console.log(`  Award: ${rec.award_level} | Points: ${rec.points}`);
  console.log(`  Message: ${rec.message}`);
  console.log(`  Value: ${rec.company_value}`);
});

Step 2: Create a Recognition Nomination


const nomination = await api.post('/api/v1/recognitions', {
  recipient_id: 'emp-12345',
  award_level: 'silver',
  company_value: 'innovation',
  message: 'Outstanding work on the Q1 product launch. Your innovative approach to the deployment pipeline saved the team 3 days of work.',
  points: 500,
  visibility: 'public',  // 'public', 'team', 'private'
});

console.log(`Recognition created: ${nomination.data.id}`);
console.log(`Status: ${nomination.data.status}`); // pending_approval or approved

Step 3: Check Recognition Status


const { data: status } = await api.get(`/api/v1/recognitions/${nomination.data.id}`);
console.log(`Status: ${status.status}`);
// Status: pending_approval -> approved -> delivered

Step 4: List Reward Catalog


const { data: catalog } = await api.get('/api/v1/rewards/catalog', {
  params: { category: 'gift_cards', country: 'US' },
});

catalog.items.forEach((item: any) => {
  console.log(`${item.name} - ${item.points_required} points`);
});

Output


Jane Smith recognized Alex Johnson
  Award: Silver | Points: 500
  Message: Outstanding work on the Q1 product launch...
  Value: Innovation
Recognition created: rec-67890
Status: pending_approval

Error Handling

Error	Cause	Solution
`422` on nomination	Missing required field	Include recipient, award_level, message
`404` recipient	Invalid employee ID	Verify against HRIS sync
`403` award level	Insufficient budget	Check recognition budget limits

Resources

Workhuman Social Recognition
…

workhuman-install-auth View full skill →

Workhuman install auth for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

Workhuman Install & Auth

Overview

Configure Workhuman API access for Social Recognition, rewards, and HRIS integration. Workhuman uses OAuth 2.0 for API authentication. The API enables programmatic recognition nominations, reward redemption, and employee data sync.

Prerequisites

Workhuman enterprise account with API access enabled
OAuth client credentials from Workhuman admin portal
HTTPS endpoint for redirect URI (if using auth code flow)

Instructions

Step 1: Configure OAuth Credentials


# .env
WORKHUMAN_CLIENT_ID=your-client-id
WORKHUMAN_CLIENT_SECRET=your-client-secret
WORKHUMAN_BASE_URL=https://api.workhuman.com
WORKHUMAN_TENANT_ID=your-tenant-id

Step 2: Obtain Access Token (Client Credentials)


import axios from 'axios';

async function getWorkhmanToken(): Promise<string> {
  const { data } = await axios.post(
    `${process.env.WORKHUMAN_BASE_URL}/oauth/token`,
    new URLSearchParams({
      grant_type: 'client_credentials',
      client_id: process.env.WORKHUMAN_CLIENT_ID!,
      client_secret: process.env.WORKHUMAN_CLIENT_SECRET!,
    }),
    { headers: { 'Content-Type': 'application/x-www-form-urlencoded' } },
  );
  return data.access_token;
}

Step 3: Verify Connection


const token = await getWorkhmanToken();
const api = axios.create({
  baseURL: process.env.WORKHUMAN_BASE_URL,
  headers: { Authorization: `Bearer ${token}` },
});

const { data } = await api.get('/api/v1/users/me');
console.log(`Connected as: ${data.displayName}`);

Step 4: Python Client


import requests, os

class WorkhumanClient:
    def __init__(self):
        self.base = os.environ["WORKHUMAN_BASE_URL"]
        self.token = self._authenticate()

    def _authenticate(self):
        resp = requests.post(f"{self.base}/oauth/token", data={
            "grant_type": "client_credentials",
            "client_id": os.environ["WORKHUMAN_CLIENT_ID"],
            "client_secret": os.environ["WORKHUMAN_CLIENT_SECRET"],
        })
        return resp.json()["access_token"]

    def get(self, endpoint, **params):
        return requests.get(f"{self.base}{endpoint}",
            headers={"Authorization": f"Bearer {self.token}"}, params=params).json()

Error Handling

Error	Cause	Solution
`401 Unauthorized`	Invalid credentials	Check client_id/secret
`403 Forbidden`	Insufficient permissions	Contact Workhuman admin
…

workhuman-local-dev-loop View full skill →

Workhuman local dev loop for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-performance-tuning View full skill →

Workhuman performance tuning for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-prod-checklist View full skill →

Workhuman prod checklist for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-rate-limits View full skill →

Workhuman rate limits for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-reference-architecture View full skill →

Workhuman reference architecture for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-sdk-patterns View full skill →

Workhuman sdk patterns for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-security-basics View full skill →

Workhuman security basics for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-upgrade-migration View full skill →

Workhuman upgrade migration for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

workhuman-webhooks-events View full skill →

Workhuman webhooks events for employee recognition and rewards API.

ReadWriteEditBash(npm:*)Grep

Endpoint	Method	Description
`/api/v1/recognitions`	GET	List recognitions
`/api/v1/recognitions`	POST	Create nomination
`/api/v1/recognitions/:id`	GET	Get recognition status
`/api/v1/users`	GET	List employees
`/api/v1/rewards/catalog`	GET	Browse reward catalog
`/api/v1/rewards/redeem`	POST	Redeem points for reward

Error	Cause	Solution
`401 Unauthorized`	Token expired	Re-authenticate
`403 Forbidden`	Insufficient permissions	Check role/permissions
`422 Validation`	Missing fields	Check required fields
`404 Not Found`	Invalid ID	Verify resource exists

Endpoint	Method	Description
`/api/v1/recognitions`	GET	List recognitions
`/api/v1/recognitions`	POST	Create nomination
`/api/v1/recognitions/:id`	GET	Get recognition status
`/api/v1/users`	GET	List employees
`/api/v1/rewards/catalog`	GET	Browse reward catalog
`/api/v1/rewards/redeem`	POST	Redeem points for reward

Error	Cause	Solution
`401 Unauthorized`	Token expired	Re-authenticate
`403 Forbidden`	Insufficient permissions	Check role/permissions
`422 Validation`	Missing fields	Check required fields
`404 Not Found`	Invalid ID	Verify resource exists

Endpoint	Method	Description
`/api/v1/recognitions`	GET	List recognitions
`/api/v1/recognitions`	POST	Create nomination
`/api/v1/recognitions/:id`	GET	Get recognition status
`/api/v1/users`	GET	List employees
`/api/v1/rewards/catalog`	GET	Browse reward catalog
`/api/v1/rewards/redeem`	POST	Redeem points for reward

workhuman-pack

Installation

What It Does

Skills (18) plugin-local skills

Workhuman Ci Integration

Overview

Instructions

Key Workhuman API Concepts

Core API Endpoints

Error Handling

Resources

Next Steps

Workhuman Common Errors

Overview

Instructions

Key Workhuman API Concepts

Core API Endpoints

Error Handling

Resources

Next Steps

Workhuman Core Workflow A

Overview

Instructions

Key Workhuman API Concepts

Core API Endpoints

Error Handling

Resources

Next Steps

Workhuman Core Workflow B

Overview

Instructions

Key Workhuman API Concepts

Core API Endpoints

Error Handling

Resources

Next Steps

Workhuman Cost Tuning

Overview

Instructions

Key Workhuman API Concepts

Core API Endpoints

Error Handling

Resources

Next Steps

Workhuman Debug Bundle

Overview

Instructions

Key Workhuman API Concepts

Core API Endpoints

Error Handling

Resources

Next Steps

Workhuman Deploy Integration

Overview

Instructions

Key Workhuman API Concepts

Core API Endpoints

Error Handling

Resources

Next Steps

Workhuman Hello World

Overview

Instructions

Step 1: List Recent Recognitions

Step 2: Create a Recognition Nomination

Step 3: Check Recognition Status

Step 4: List Reward Catalog

Output

Error Handling

Resources

Workhuman Install & Auth

Overview

Prerequisites

Instructions

Step 1: Configure OAuth Credentials

Step 2: Obtain Access Token (Client Credentials)

Step 3: Verify Connection

Step 4: Python Client

Error Handling

Workhuman Local Dev Loop