Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/workhuman-pack/skills/workhuman-reference-architecture/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill workhuman-reference-architecture. Copyright stays with the author (MIT).

Workhuman Reference Architecture

Name: workhuman-reference-architecture
Author: jeremylongshore

Overview

Guidance for reference architecture with Workhuman Social Recognition and rewards API.

Instructions

Key Workhuman API Concepts

Auth: OAuth 2.0 client credentials flow
Recognition: Peer-to-peer and manager nominations with points
Awards: Configurable levels (bronze, silver, gold, platinum)
Values: Company values attached to recognitions
HRIS Sync: Bidirectional sync with Workday, SAP SuccessFactors
Integrations: Microsoft Teams, Slack, Outlook native plugins

Core API Endpoints

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 Handling

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

Resources

Next Steps

See related Workhuman skills for more patterns.

{ "ocm": "1", "id": "jeremylongshore-tons-of-skills-marketplace-workhuman-ref-c5c695", "kind": "skill", "name": "workhuman-reference-architecture", "description": "Workhuman reference architecture for employee recognition and rewards API. Use when integrating Workhuman Social Recognition, or building recognition workflows with HRIS systems. Trigger: \"workhuman reference architecture\".", "publisher": "jeremylongshore", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "saas", "hr", "recognition", "workhuman", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Workhuman reference architecture for employee recognition and rewards API. Use when integrating Workhuman Social Recognition, or building recognition workflows with HRIS systems. Trigger: \"workhuman reference architecture\"." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace", "path": "plugins/saas-packs/workhuman-pack/skills/workhuman-reference-architecture/SKILL.md", "ref": "HEAD", "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/saas-packs/workhuman-pack/skills/workhuman-reference-architecture/SKILL.md", "key": "jeremylongshore/tons-of-skills-marketplace/plugins/saas-packs/workhuman-pack/skills/workhuman-reference-architecture/SKILL.md" }, "compatibility": "Designed for Claude Code", "allowed_tools": [ "Read,", "Write,", "Edit,", "Bash(npm:*),", "Grep" ], "license": "MIT" }, "instructions": "# Workhuman Reference Architecture\n\n## Overview\n\nGuidance for reference architecture with Workhuman Social Recognition and rewards API.\n\n## Instructions\n\n### Key Workhuman API Concepts\n\n- **Auth**: OAuth 2.0 client credentials flow\n- **Recognition**: Peer-to-peer and manager nominations with points\n- **Awards**: Configurable levels (bronze, silver, gold, platinum)\n- **Values**: Company values attached to recognitions\n- **HRIS Sync**: Bidirectional sync with Workday, SAP SuccessFactors\n- **Integrations**: Microsoft Teams, Slack, Outlook native plugins\n\n### Core API Endpoints\n\n| Endpoint | Metho", "cost": { "context_tokens": 381 } }

workhuman-reference-architecture

About