Adding Markee messages to skill.md files
The goal is: onchain leaderboard state change → backend detects it → rewrites the MARKEE block in a repo's SKILL.md via GitHub API → instant commit to main.
Components needed
- GitHub App setup
- Create Markee GitHub App with
contents: write permission
- Build install flow so maintainers can auth their repo in ~2 clicks
- Store per-repo installation tokens securely
- Subgraph event listener
- Poll or webhook on TopDawgStrategy bid/outbid events
- Needs to know which repos are subscribed to which leaderboard contract
- MARKEE block renderer
- Function that takes current leaderboard state → formats the markdown block
- Decide on format (positions, messages, addresses, timestamps?)
- GitHub Contents API writer
- Fetch current file → find delimiters → replace block → commit
- Handle edge cases: delimiter missing, file doesn't exist, merge conflicts
- Repo registry
- DB table mapping
repo → leaderboard contract address → installation token
- Needed so the listener knows what to sync when a bid event fires
- Maintainer onboarding flow
- UI on markee.xyz where maintainer connects GitHub + pastes their leaderboard address
- Instructions for adding the MARKEE delimiters to their SKILL.md
Checklist
- [ ] Register Markee GitHub App in GitHub Developer settings
- [ ] Implement OAuth install flow + token storage
- [ ] Create repo registry table in your DB
- [ ] Build subgraph event listener for TopDawgStrategy
- [ ] Write MARKEE block formatter
- [ ] Write GitHub Contents API sync function
- [ ] Wire listener → formatter → sync
- [ ] Build maintainer onboarding UI