manage-awardslisted
Install: claude install-skill bonusly/bonusly-claude-plugin
Awards are the custom recognition types in Bonusly — things like peer-nominated awards, spot bonuses, claimable achievements, or company-specific milestones. This skill covers the full lifecycle: reviewing what exists, creating new ones, updating them, and retiring them.
**Reviewing awards**
Call `adminListAwards` with `state: 'active'` by default to show the current catalog. Present key fields for each: name, type (claimable or manual), budget, period, approval level, and whether it's active.
For details on a specific award, call `adminShowAward` with its ID.
To see how much has been spent on an award, call `adminRewardsTotalsReport` and look for that award in the results.
To see the employee-facing view (what people can actually see and claim), use `listAwards` or `showAward`.
**Giving an award**
Use `giveAward` to hand a manual award to one or more recipients. First find the award with `listAwards` (or `adminListAwards`) to get its `award_id` — or pass `award_name` (exact, case-insensitive). `recipients` is an array of user ids, emails, or display names; no `@mention` formatting needed.
The award itself dictates which extra inputs are honored. Check the award's `amount_editable`, `reason_editable`, and `bonus_privacy_changeable` flags (returned by `listAwards`) before offering to set `amount`, `message`, or `privacy` — they're silently ignored otherwise. `hide_giver` is always available.
Giving creates an approval request. Auto-approved awards return the created `