reward

Motto: Rewards should feel earned and fitting.

⭐4stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The Reward Protocol is a specialized gamification and narrative design skill for Claude agents, designed to create immersive and meaningful feedback loops. It automates the generation of contextually relevant rewards—ranging from digital items and titles to buffs and knowledge—ensuring that every achievement feels earned and thematically consistent. By integrating scaling logic and state management, this skill enhances user retention and engagement in interactive experiences, educational platforms, and creative storytelling.

Use Cases

  • Interactive Narrative & RPGs: Dynamically generate lore-accurate loot, titles, and reputation boosts based on a player's specific actions and quest difficulty.
  • Gamified Learning & EdTech: Motivate students by granting 'Knowledge' rewards, unlocking new course 'Access', or awarding academic 'Titles' upon completing complex modules.
  • Productivity & Task Management: Transform workflow completion into a rewarding system where finishing high-priority tasks earns the user 'Buffs' or virtual 'Currency'.
  • Community & Social Engagement: Manage social proof and status by awarding specific 'Heirlooms' or 'Titles' to users who reach significant contribution milestones within a community.
namereward
description"Motto: Rewards should feel earned and fitting."
licenseMIT
tier1
related[scoring, buff, hero-story, adventure]
tags[moollm, achievement, prizes, narrative, game]

Reward Protocol

Dynamic achievement rewards — the treasure matches the quest. "Rewards should feel earned and fitting."

Core Principle

Thematic Appropriateness

Rewards match achievements:

  • Slay a dragon → dragon-themed rewards (scales, hoard, reputation)
  • Save a village → village's gratitude (shelter, allies, title)
  • Solve a puzzle → knowledge rewards (secrets, techniques, lore)

Reward Types

Type Examples When Granted
Items Weapons, tools, treasures Combat, exploration
Gold Currency, valuables Commerce, quests
Buffs Temporary powers Heroic moments
Titles LIGHT-BEARER, DRAGON-SLAYER Major achievements
Abilities New skills, techniques Learning, training
Access Keys, permissions, trust Social achievements
Knowledge Secrets, lore, maps Investigation
Heirlooms Items with history Generational play

Methods

GRANT - Give a Reward

invoke: GRANT
params:
  recipient: "Who gets it"
  achievement: "What they did"
  reward: "What they get (or auto-generate)"
effect:
  - Add to recipient's inventory or state
  - Record in achievement log
  - Narrate the granting

GENERATE - Create Thematic Reward

invoke: GENERATE
params:
  achievement: "What was accomplished"
  context: "Where and how"
effect:
  - Analyze achievement theme
  - Generate appropriate reward
  - Propose with justification

Reward Generation Logic

Achievement: "Rescued the blacksmith from the fire"
Context: Village fire, heroic action

Thematic analysis:
  - Fire → fire-related items?
  - Blacksmith → smithing reward?
  - Heroic → reputation boost?

Generated rewards:
  1. Fireproof cloak (practical, thematic)
  2. Free repairs for life (relationship)
  3. Title: FLAME-WALKER (reputation)
  4. Secret: location of rare ore (knowledge)

Scaling Rewards

Achievement Level Reward Scale
Minor task Small token, few coins
Significant quest Useful item, title
Major accomplishment Powerful item, ability
Legendary feat Unique artifact, lasting fame

Curse Lifting Rewards

When curses are lifted, special rewards apply:

curse:
  name: "Curse of Darkness"
  lift_condition: "Light 3 dark places"
  
reward_on_lift:
  - title: "LIGHT-BEARER"
  - ability: "Glow in darkness"
  - knowledge: "Location of the Shadow Temple"

Delayed Rewards

Some rewards mature over time:

delayed_reward:
  type: "Planted seed"
  matures: "After 3 game days"
  becomes: "Magical fruit tree"
  
relationship_reward:
  type: "Merchant's favor"
  grows_with: "Repeated business"
  becomes: "Exclusive supplier"

State

reward_state:
  earned_rewards: []
  pending_rewards: []
  titles: []
  achievements_log:
    - date: "2026-01-15"
      achievement: "Rescued the blacksmith"
      reward: "Fireproof cloak"

Integration

Skill Integration
scoring Score determines reward quality
buff Some rewards are buffs
economy Gold rewards
character Rewards update character state
adventure Quest completion triggers rewards

Safety Guidelines

  • Proportional — reward matches difficulty
  • Consistent — similar achievements, similar rewards
  • Meaningful — rewards should matter to the story
  • No inflation — keep rewards valuable

Example Session

> [Player completes fire rescue quest]

GENERATE: achievement="rescued blacksmith from fire"

Analysis:
- Heroic action in dangerous situation
- Relationship established with craftsman
- Fire element prominent

Proposed rewards:
1. 🛡️ Fireproof Cloak - practical protection
2. 🔨 Free Smithing - relationship benefit
3. 🏆 Title: FLAME-WALKER - reputation

Which feels right for this character?