api-leaderboard

Track scores and manage global and friends leaderboards for Spectacles Lenses.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/specs-devs/agentic-tools --skill api-leaderboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-leaderboard
Source: https://github.com/specs-devs/agentic-tools/tree/main/skills/api-leaderboard
Command: npx skills add https://github.com/specs-devs/agentic-tools --skill api-leaderboard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides turnkey score tracking and leaderboards for Spectacles Lenses by leveraging the LeaderboardModule, enabling competitive gameplay and player rankings across Lenses.

Core Features & Use Cases

  • Global and Friends leaderboards with score submission and TTL-based lifecycle.
  • Read and display top players, track individual progress, and compare performances across Lens sessions.
  • Use Case: add competitive scoring to a Lens-based game or challenge where players rank by score and time-to-live constraints.

Quick Start

Create or retrieve a leaderboard and submit a score to see it reflected in the rankings.

Frequently Asked Questions about api-leaderboard

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

FAQPage Schema
How do I add score tracking and leaderboards to a Spectacles Lens?

To add score tracking to Spectacles Lenses, use the LeaderboardModule API to create leaderboards, submit scores, and fetch global or friends-based rankings to display competitive gameplay results.

Can I create a friends-only ranking system for my Spectacles game?

Yes, the LeaderboardModule API supports friends-based rankings alongside global leaderboards, allowing you to fetch and display top players and compare performances specifically within a player's friend network.

How do score submissions and TTL-based lifecycles work in Lens leaderboards?

Score submissions are managed through the LeaderboardModule API, which utilizes a TTL-based lifecycle to automatically manage and expire leaderboard data, ensuring rankings remain current across Lens sessions.

What is the best way to retrieve and display top players in Spectacles?

The best way to retrieve top players in Spectacles is by calling the LeaderboardModule API to fetch leaderboard data, which returns ranked scores that you can then render and display within your Lens interface.

How do I track individual player progress across different Lens sessions?

You can track individual player progress by submitting scores to the LeaderboardModule API after each session, then fetching the leaderboard data to compare the player's current performance against their previous rankings.

Do I need any external dependencies to implement leaderboard data management?

No external dependencies are required to implement leaderboard data management, as the Skill integrates directly with the LeaderboardModule API to handle creation, submission, fetching, and TTL-based lifecycle management natively.