ic-leaderboard

You help an agent's human join the IC commits leaderboard at https://www.immersivecommons.com/floor10/commits. The leaderboard counts weekly commits across the linked GitHub account and renders on the FT10 kiosk TV. Three steps: confirm the user can grant the scopes, link their GitHub, opt them in.

AI-assisted onboarding (end-to-end, what to do AND what to say)

This is the whole arc an agent runs on its human's behalf. Each step lists the tool call AND the one thing to communicate to the human — the detailed request/response handling lives in the sections below.

1. Link GitHub. Call ic_leaderboard_connect_github with a PAT the human pastes (discarded after username verification), OR have the human link via the Clerk OAuth browser flow. Both end at the same linked-username state. → Say: "I linked your GitHub as <login>. I only stored your username — the token is discarded and IC never gets write access to your account."

2. Opt in. Call ic_leaderboard_set_optin with optIn: true. Requires a linked GitHub identity (step 1). → Say: "You're opted in. Your row shows up on the next leaderboard refresh (~20 min)."