contributor-reward

Generate tier-priced weekly reward plans from fork contributor leaderboards.

6|2|Updated May 21, 2026
One-click install
npx skills add https://github.com/anajuliabit/aeon --skill contributor-reward
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contributor-reward
Source: https://github.com/anajuliabit/aeon/tree/main/skills/contributor-reward
Command: npx skills add https://github.com/anajuliabit/aeon --skill contributor-reward

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual wiring between a weekly contributor leaderboard and a clear, tier-priced rewards plan by automatically translating rankings into an operator-ready distribution file.

Core Features & Use Cases

  • Leaderboard-to-reward planning: Reads the weekly fork-contributor-leaderboard article, extracts top contributors, and maps ranks to tiered USDC amounts.
  • First-PR bonus tracking (idempotent): Applies the one-time ✨ first-PR bonus per login using memory/state/contributor-reward-state.json, and prevents re-awarding across runs.
  • Safe, money-adjacent workflow: Writes only the plan to memory/distributions.yml and notifies the operator with a next-step command to run distribute-tokens separately.
  • Re-process with deltas: Detects leaderboard re-runs and updates the state for changed entries by adding only deltas for already-processed weeks (no demotion clawbacks).

Quick Start

Run contributor-reward with an ISO week override to generate that week’s plan (and optionally use dry-run to preview) from the latest leaderboard data.

Frequently Asked Questions about contributor-reward

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a GitHub contributor leaderboard into a tier-priced USDC reward plan?

To convert a GitHub contributor leaderboard into a tier-priced USDC reward plan, this process reads leaderboard articles, extracts top contributors, and maps ranks to tiered amounts. It outputs an operator-ready distribution file without executing transfers.

How does idempotent first-PR bonus tracking work for community token distribution?

Idempotent first-PR bonus tracking uses a local state file to record awarded bonuses per login. This prevents re-awarding the one-time first-PR bonus across multiple community token distribution runs, ensuring duplicate-free reward planning.

Can I use a dry-run preview before finalizing weekly USDC contributor rewards?

Yes, you can use a dry-run to preview weekly USDC contributor rewards. By running the process with an ISO week override, you can safely generate the plan and review the output before any downstream distribution steps are taken.

What happens to USDC reward plans if the contributor leaderboard is re-processed?

When a contributor leaderboard is re-processed, the system updates state for changed entries by adding only deltas for already-processed weeks. This ensures accurate USDC reward plans without applying demotion clawbacks for lower-ranked contributors.

How do I handle weekly token distribution without automatically executing blockchain transfers?

Weekly token distribution is handled by writing only the reward plan to a local distributions file. The system safely prepares the plan and notifies the operator with a next-step command to execute transfers separately, preventing automated money movement.