Agent skill

reward

Motto: Rewards should feel earned and fitting.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/reward

SKILL.md

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

yaml
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

yaml
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:

yaml
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:

yaml
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

yaml
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?

Didn't find tool you were looking for?

Be as detailed as possible for better results