contributor-reward

To automate weekly contributor token rewards, this Skill translates leaderboard rankings from markdown files into tiered USDC distribution instructions and writes them to distributions.yml. It calculates payouts for top contributors while enforcing idempotent state updates to prevent duplicate transfers.

Yes, you can preview token distributions using the dry-run mode. This allows you to generate and review the reward plan written to distributions.yml without executing any actual blockchain transfers, ensuring your payout calculations are correct before commitment.

The system prevents duplicate payouts by enforcing idempotent state updates. It tracks per-week state and first-PR bonuses in a dedicated JSON file, ensuring that re-running the reward plan for the same ISO week does not overwrite existing distributions or issue redundant rewards.

The system calculates first-PR bonuses by checking contributor history against stored state. It identifies eligible new contributors within the top ranks, applies the bonus to their tier-priced USDC reward, and records the bonus status to maintain idempotent re-runs.

The minimum score threshold is a configured requirement that contributors must meet to qualify for rewards. The Skill targets only the top contributors ranked 1-5 who exceed this score, ensuring that token distributions are allocated exclusively to high-impact participants.

Your distributions.yml file does not update because the Skill enforces safe write rules to prevent overwriting existing distribution records. This idempotent behavior ensures that previously generated payout plans remain intact when you re-run the process for the same week.