Agent skill

Lol Helper

by shepherdjerred in shepherdjerred/monorepo

League of Legends domain knowledge, terminology, and Riot Games API reference.

GPL-3.0Auto-check passedBackend & APIs

Install Lol Helper

skills CLI

$ npx skills add shepherdjerred/monorepo --skill lol-helper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install shepherdjerred/monorepo lol-helper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/lol-helper .claude/skills/lol-helper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "lol-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/lol-helper into .claude/skills/lol-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lol-helper", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/lol-helper

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add shepherdjerred/monorepo --skill lol-helper -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install shepherdjerred/monorepo lol-helper --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/lol-helper .agents/skills/lol-helper && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "lol-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/lol-helper into .agents/skills/lol-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lol-helper", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add shepherdjerred/monorepo --skill lol-helper -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install shepherdjerred/monorepo lol-helper --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/lol-helper .cursor/skills/lol-helper && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "lol-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/lol-helper into .cursor/skills/lol-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lol-helper", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/shepherdjerred/monorepo.git --path packages/dotfiles/dot_agents/skills/lol-helper

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add shepherdjerred/monorepo --skill lol-helper -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install shepherdjerred/monorepo lol-helper --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/lol-helper .gemini/skills/lol-helper && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "lol-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/lol-helper into .gemini/skills/lol-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lol-helper", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install shepherdjerred/monorepo lol-helper

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add shepherdjerred/monorepo --skill lol-helper -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/lol-helper .github/skills/lol-helper && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "lol-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/lol-helper into .github/skills/lol-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lol-helper", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add shepherdjerred/monorepo --skill lol-helper -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install shepherdjerred/monorepo lol-helper --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/lol-helper .opencode/skills/lol-helper && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "lol-helper" agent skill from https://github.com/shepherdjerred/monorepo/tree/main/packages/dotfiles/dot_agents/skills/lol-helper into .opencode/skills/lol-helper/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lol-helper", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: lol-helper
GitHub stars: 112
Token cost: ~6.7k tokens
SKILL.md length: 1,893 words
Files: 1
Skills in repo: 63
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: GPL-3.0

At a glance

League of Legends domain knowledge, terminology, and Riot Games API reference.

Works in 3 steps: Application Rate Limit - Per API key,… → Method Rate Limit - Per endpoint, per… → Service Rate Limit - Per service, shared…
Working with match data
SKILL.md covers Ranked System, Queue Types, Champion Classes and Game Objectives, plus 2 more sections
Reaches ddragon.leagueoflegends.com and na1.api.riotgames.com

What it does

Lol Helper is an agent skill from shepherdjerred/monorepo. League of Legends domain knowledge, terminology, and Riot Games API reference. Use when working with match data, champion info, ranked systems, game objectives, items, runes, player statistics, Riot API client, API endpoints, rate limiting, PUUID lookups, summoner info, or regional routing.

Its SKILL.md is about 6.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Statistics, REST APIs and Rate limiting. The repository describes itself as: Monorepo for all of my projects. The licence is GPL-3.0.

When your agent uses it

Working with match data
Game objectives
Player statistics
Riot API client

Example prompts

“/lol-helper”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Application Rate Limit - Per API key, per region
Method Rate Limit - Per endpoint, per key, per region
Service Rate Limit - Per service, shared across all applications

What it can do on your machine

Read from SKILL.md and the folder at commit bc57ca5. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- ddragon.leagueoflegends.com
- na1.api.riotgames.com
- americas.api.riotgames.com
Also links to:
- wiki.leagueoflegends.com
- dignitas.gg
- developer.riotgames.com
- darkintaqt.com
- riotgames.com
- mobalytics.gg
- esportsinsider.com
- raw.communitydragon.org
- riot-api-libraries.readthedocs.io
- hextechdocs.dev
- leagueoflegends.fandom.com
- support-leagueoflegends.riotgames.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lol Helper loads about 6.7k tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 1,893 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~76
When it runs · the whole SKILL.md, loaded when a task matches: ~6.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shepherdjerred/monorepo at commit bc57ca5, republished under its GPL-3.0 licence (© shepherdjerred). 1,893 words, ~6,688 tokens.

Download SKILL.mdSave it as .claude/skills/lol-helper/SKILL.md (or your agent's skills folder).

name: lol-helper
description: League of Legends domain knowledge, terminology, and Riot Games API reference. Use when working with match data, champion info, ranked systems, game objectives, items, runes, player statistics, Riot API client, API endpoints, rate limiting, PUUID lookups, summoner info, or regional routing.

League of Legends Helper

Complete reference for League of Legends game concepts, terminology, data structures, and Riot Games API integration.

Part 1: Game Domain Reference

Ranked System

Tiers (Low to High)

Tier	Divisions	Notes
Iron	IV, III, II, I	Lowest tier
Bronze	IV, III, II, I
Silver	IV, III, II, I	Most populated
Gold	IV, III, II, I
Platinum	IV, III, II, I
Emerald	IV, III, II, I	Added Season 13
Diamond	IV, III, II, I
Master	None	Top 0.2%
Grandmaster	None	Top players, 200+ LP
Challenger	None	Top 300 players per region

LP (League Points)

Gain/lose LP from wins/losses
Iron-Platinum: baseline +/-25 LP
Emerald+: baseline +/-20 LP
Promotion between divisions at 100 LP
Master+ uses continuous LP (no promotions)
Grandmaster requires 200+ LP in Master
Challenger requires 500+ LP

Queue Restrictions

Solo/Duo:

Most players: queue within 1 tier
Iron: can queue up to 2 tiers higher
Diamond+: within 2 divisions only
Grandmaster+: solo only

Flex:

Diamond and below: no restrictions
Master+: must be Emerald+ to queue together

Queue Types

Ranked Queues

Queue	ID	Players	Notes
Solo/Duo	420	1-2	Main competitive queue
Flex 5v5	440	1, 2, 3, or 5	No parties of 4

Casual Queues

Queue	ID	Notes
Normal (Draft)	400	Same rules as ranked
Normal (Blind)	430	Mirror matchups allowed
ARAM	450	All Random, All Mid

Special Queues

Queue	Notes
Clash	Tournament mode
Arena	2v2v2v2 mode
URF	Ultra Rapid Fire (rotating)
One for All	All same champion (rotating)

Champion Classes

Primary Classes

Class	Role	Examples
Tank	Absorb damage, initiate	Malphite, Ornn, Leona
Fighter	Sustained damage + durability	Darius, Fiora, Jax
Assassin	Burst damage, high mobility	Zed, Akali, Katarina
Mage	Ability-based damage	Lux, Syndra, Orianna
Marksman	Sustained ranged damage	Jinx, Caitlyn, Kai'Sa
Support	Utility, protection	Thresh, Lulu, Yuumi

Fighter Subclasses

Subclass	Traits	Examples
Juggernaut	Low mobility, high damage/durability	Darius, Mordekaiser, Garen
Diver	Engage into backline	Irelia, Vi, Camille

Mage Subclasses

Subclass	Traits	Examples
Burst Mage	High combo damage	Syndra, Annie, Veigar
Battlemage	Sustained AoE in fights	Cassiopeia, Ryze, Swain
Artillery Mage	Extreme range	Xerath, Lux, Vel'Koz

Assassin Subclasses

Subclass	Traits	Examples
Assassin	Quick in-and-out	Zed, Talon, Akali
Skirmisher	Extended duels	Yasuo, Yone, Fiora

Game Objectives

Dragons (Elemental Drakes)

Spawn at 5:00, respawn 5 minutes after killed. One team getting 4 drakes grants Dragon Soul.

Drake	Buff	Soul Effect
Infernal	+AD/AP	Attacks cause AoE explosion
Mountain	+Armor/MR	Shield after not taking damage
Ocean	+HP regen	Damaging enemies heals you
Cloud	+Movement speed (OOC)	+Movement speed (permanent)
Hextech	+Attack speed + ability haste	Chain lightning on attacks
Chemtech	+Tenacity + heal/shield power	Brief zombie state on death

Elder Dragon

Spawns after one team gets Dragon Soul
Grants Elder Dragon buff: bonus true damage + execute enemies below 20% HP
Game-ending objective

Baron Nashor

Spawns at 20:00
Hand of Baron buff (210 seconds):
- Empowered Recall (4 seconds)
- Bonus AD/AP
- Empowers nearby minions significantly
Primary objective for sieging/ending

Rift Herald

Spawns at 8:00, despawns at 19:45
Drops Eye of the Herald (consume to summon Herald)
Herald charges towers for massive damage
Can spawn twice (second at 13:45 if first killed before 13:45)

Void Grubs

Spawn at 5:00 in groups of 3
Grant Voidmite stacks (up to 6)
Voidmites attack structures alongside you
Alternative early objective to dragons

Match Statistics

Core Stats

Stat	Description
KDA	Kills/Deaths/Assists ratio: (K+A)/D
CS	Creep Score (minions + jungle monsters killed)
Gold	Total gold earned
Damage Dealt	Total damage to champions
Damage Taken	Total damage received
Vision Score	Wards placed + destroyed + control

Gold Values

Event	Gold
Melee minion	~21
Caster minion	~14
Cannon minion	~60-90
Champion kill (base)	300
First Blood	+100 bonus
Assist	~half of kill gold
Shutdown (2+ kills)	+150 per streak level
Dragon	~25-100 per player
Baron	~300 per player
Tower	~50-250 local + ~100 global

Bounty System

Kill Streak	Bounty
0 (base)	300
2 kills	450
3 kills	600
4 kills	700
5 kills	800
6 kills	900
7+ kills	1000 (max)

Runes Reforged

Rune Paths

Path	Theme	Classes
Precision	Sustained damage, attacks	Marksmen, fighters
Domination	Burst damage, hunting	Assassins, mages
Sorcery	Abilities, utility	Mages, enchanters
Resolve	Durability, defense	Tanks, supports
Inspiration	Creative, rule-breaking	Various

Precision Keystones

Keystone	Effect
Press the Attack	3 hits = bonus damage + damage amp
Lethal Tempo	Stacking attack speed
Fleet Footwork	Energized heal + movement speed
Conqueror	Stacking AD/AP + healing

Domination Keystones

Keystone	Effect
Electrocute	3 hits/abilities = burst damage
Dark Harvest	Execute-style scaling damage
Hail of Blades	Burst attack speed (3 attacks)
Predator	Movement speed + damage on first hit

Sorcery Keystones

Keystone	Effect
Summon Aery	Damage enemies or shield allies
Arcane Comet	Ability hits launch comet
Phase Rush	3 hits = burst of movement speed

Resolve Keystones

Keystone	Effect
Grasp of the Undying	Periodic empowered attack + heal
Aftershock	CC triggers resistances + damage
Guardian	Shield nearby ally when damaged

Inspiration Keystones

Keystone	Effect
Glacial Augment	Slowing zone on immobilize
Unsealed Spellbook	Swap summoner spells
First Strike	Bonus gold/damage when striking first

Summoner Spells

Spell	Cooldown	Effect
Flash	300s	Blink short distance
Ignite	180s	True damage DoT + Grievous Wounds
Teleport	360s	Channel to allied structure/minion
Heal	240s	Heal self + ally + movement speed
Exhaust	210s	Slow + damage reduction on enemy
Barrier	180s	Temporary shield
Cleanse	210s	Remove CC + reduce incoming CC
Ghost	210s	Movement speed boost
Smite	90s	Damage to monster/minion (jungler)

Common Combinations

Role	Common Spells
Top	Flash + Teleport, Flash + Ignite
Jungle	Flash + Smite (required)
Mid	Flash + Ignite, Flash + Teleport
ADC	Flash + Heal
Support	Flash + Ignite, Flash + Exhaust

Common Terminology

Gameplay Terms

Term	Meaning
AA	Auto-attack (basic attack)
AoE	Area of Effect
CC	Crowd Control (stun, slow, etc.)
CD	Cooldown
DPS	Damage Per Second
DoT	Damage over Time
OOM	Out of Mana
OOC	Out of Combat

Strategic Terms

Term	Meaning
Aggro	Aggressive play/drawing enemy attention
All-in	Commit all abilities for a kill
Backdoor	Destroy nexus by bypassing enemy team
Dive	Attack under enemy tower
Gank	Surprise attack from jungler
Kite	Attack while retreating
Peel	Protect carry from threats
Poke	Harass from range
Roam	Leave lane to help elsewhere
Split push	Push side lane while team distracts
Zone	Deny area to enemies with threat

Player State Terms

Term	Meaning
Fed	Has many kills, strong
Behind	Less gold/XP than opponent
Tilted	Frustrated, playing worse
Autofill	Assigned non-preferred role

Meta Terms

Term	Meaning
Meta	Most effective tactics available
Powerspike	Point where champion becomes strong
Scaling	Champion strength growth over time
Early/Mid/Late game	Game phases (~0-15/15-30/30+ min)

Match Phases

Early Game (0-15 min)

Laning phase
First tower priority
Drake and Herald contests
Jungle path optimization

Mid Game (15-30 min)

Towers falling
Roaming and skirmishing
Dragon Soul race
Baron attempts

Late Game (30+ min)

Full builds approaching
Baron/Elder Dragon crucial
One fight can end game
Death timers are long

Part 2: Riot Games API Reference

API Endpoints Overview

Account-V1 (Riot ID Lookup)

Base URL: https://{region}.api.riotgames.com/riot/account/v1/

Endpoint	Description
`/accounts/by-riot-id/{gameName}/{tagLine}`	Get PUUID by Riot ID
`/accounts/by-puuid/{puuid}`	Get account info (gameName + tagLine) by PUUID

Important: Riot IDs replaced summoner names as of November 20, 2023. The by-name endpoints are deprecated.

Show full SKILL.md (760 more words)Show less

Summoner-V4

Base URL: https://{platform}.api.riotgames.com/lol/summoner/v4/

Endpoint	Description
`/summoners/by-puuid/{puuid}`	Get summoner by PUUID (recommended)
`/summoners/{summonerId}`	Get summoner by encrypted summoner ID
`/summoners/by-account/{accountId}`	Get summoner by encrypted account ID

Match-V5

Base URL: https://{region}.api.riotgames.com/lol/match/v5/

Endpoint	Description
`/matches/by-puuid/{puuid}/ids`	Get list of match IDs for a player
`/matches/{matchId}`	Get match details by match ID
`/matches/{matchId}/timeline`	Get match timeline (not all matches have this)

Query Parameters for matchlist:

start - Start index (default 0)
count - Number of matches (default 20, max 100)
queue - Filter by queue ID
type - Filter by match type (ranked, normal, etc.)
startTime / endTime - Filter by timestamp (epoch seconds)

League-V4

Base URL: https://{platform}.api.riotgames.com/lol/league/v4/

Endpoint	Description
`/entries/by-summoner/{summonerId}`	Get ranked entries for a summoner
`/entries/{queue}/{tier}/{division}`	Get all entries for a tier/division
`/challengerleagues/by-queue/{queue}`	Get challenger league
`/grandmasterleagues/by-queue/{queue}`	Get grandmaster league
`/masterleagues/by-queue/{queue}`	Get master league

Note: If a player hasn't finished placements or isn't ranked in a queue, that queue won't appear in results.

Champion-Mastery-V4

Base URL: https://{platform}.api.riotgames.com/lol/champion-mastery/v4/

Endpoint	Description
`/champion-masteries/by-puuid/{puuid}`	Get all champion masteries
`/champion-masteries/by-puuid/{puuid}/top`	Get top champion masteries
`/scores/by-puuid/{puuid}`	Get total mastery score

Spectator-V5

Base URL: https://{platform}.api.riotgames.com/lol/spectator/v5/

Endpoint	Description
`/active-games/by-summoner/{puuid}`	Get current game info (404 if not in game)
`/featured-games`	Get list of featured games

Limitations: Stats like role, KDA, or CS are not included. Custom game data is not available due to privacy policies.

Challenges-V1

Base URL: https://{platform}.api.riotgames.com/lol/challenges/v1/

Endpoint	Description
`/player-data/{puuid}`	Get player challenge progress
`/challenges/config`	Get all challenge configurations
`/challenges/{challengeId}/leaderboards/by-level/{level}`	Get challenge leaderboard (MASTER/GRANDMASTER/CHALLENGER)

Regional vs Platform Routing

Platform Routing Values

Used for most endpoints (Summoner-V4, League-V4, Champion-Mastery-V4, Spectator-V5):

Platform	Region
`na1`	North America
`euw1`	Europe West
`eun1`	Europe Nordic & East
`kr`	Korea
`jp1`	Japan
`br1`	Brazil
`la1`	Latin America North
`la2`	Latin America South
`oc1`	Oceania
`tr1`	Turkey
`ru`	Russia
`ph2`	Philippines
`sg2`	Singapore
`th2`	Thailand
`tw2`	Taiwan
`vn2`	Vietnam

Regional Routing Values

Used for Account-V1 and Match-V5:

Region	Platforms Covered
`americas`	NA1, BR1, LA1, LA2
`europe`	EUW1, EUN1, TR1, RU
`asia`	KR, JP1
`sea`	PH2, SG2, TH2, TW2, VN2

Example URLs:

text

Platform: https://na1.api.riotgames.com/lol/summoner/v4/summoners/by-puuid/{puuid}
Regional: https://americas.api.riotgames.com/lol/match/v5/matches/by-puuid/{puuid}/ids

Rate Limiting

Three Types of Rate Limits

Application Rate Limit - Per API key, per region
- Development keys: 20 requests/second, 100 requests/2 minutes
- Production keys: Higher limits based on approval
Method Rate Limit - Per endpoint, per key, per region
- Each endpoint has its own limit (e.g., match history may be more restricted)
Service Rate Limit - Per service, shared across all applications
- Can cause 429 errors without X-Rate-Limit-Type header

Rate Limit Headers

Header	Description
`X-App-Rate-Limit`	Your app's rate limit
`X-App-Rate-Limit-Count`	Current count against app limit
`X-Method-Rate-Limit`	Endpoint's rate limit
`X-Method-Rate-Limit-Count`	Current count against method limit
`Retry-After`	Seconds to wait before retrying (on 429)

Error Handling

Code	Meaning	Action
`429`	Rate limit exceeded	Wait for `Retry-After` seconds
`403`	Forbidden (invalid/blacklisted key)	Check API key validity
`404`	Not found	Resource doesn't exist (e.g., player not in game)

Blacklisting: Repeated violations result in temporary blacklisting (escalating duration), eventually permanent.

PUUID and Riot ID

Identifier Types

ID Type	Scope	Use Case
PUUID	Global, permanent	Preferred for all lookups
Summoner ID	Per-region	Legacy, still used in some endpoints
Account ID	Per-region	Legacy
Riot ID	Global	Display name (gameName#tagLine)

Recommended Workflow

Get PUUID from Riot ID:

text

GET /riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}

Use PUUID for all subsequent calls:

text

GET /lol/match/v5/matches/by-puuid/{puuid}/ids
GET /lol/summoner/v4/summoners/by-puuid/{puuid}

Note: PUUIDs are encrypted per project. A PUUID from your dev key won't work with your production key.

Data Dragon (Static Data)

Base URLs

Versions: https://ddragon.leagueoflegends.com/api/versions.json
Data: https://ddragon.leagueoflegends.com/cdn/{version}/data/{locale}/
Images: https://ddragon.leagueoflegends.com/cdn/{version}/img/

Common Data Files

File	Content
`champion.json`	All champions (basic info)
`champion/{name}.json`	Single champion (detailed)
`item.json`	All items
`summoner.json`	Summoner spells
`runesReforged.json`	Runes
`profileicon.json`	Profile icons

Example URLs

text

Champions: https://ddragon.leagueoflegends.com/cdn/14.24.1/data/en_US/champion.json
Items: https://ddragon.leagueoflegends.com/cdn/14.24.1/data/en_US/item.json
Champion image: https://ddragon.leagueoflegends.com/cdn/14.24.1/img/champion/Ahri.png
Item image: https://ddragon.leagueoflegends.com/cdn/14.24.1/img/item/1001.png

Community Dragon

Data Dragon can be inaccurate (especially champion spell data). Use Community Dragon (cdragon) for more accurate data:

https://raw.communitydragon.org/

Riot API Client Usage

This repository uses a native type-safe RiotClient in #src/league/api/client/riot-client.ts. It combines concurrency limiting, a client-wide Retry-After cooldown for 429 responses, and per-request 503 retry.

Basic Setup

typescript

import { riotClient } from "#src/league/api/api.ts";
import { regionToPlatformRoute, platformToRegionalRoute } from "@scout-for-lol/data";

Common Operations

typescript

// Get Account by Riot ID
const account = await riotClient.account.getByRiotId(
  gameName,
  tagLine,
  "AMERICAS", // RegionalRoute
);

// Get match history
const matches = await riotClient.match.list(puuid, "AMERICAS", {
  count: 20,
});

// Get match details (raw JSON for Zod parsing via strict-with-fallback)
const rawMatch = await riotClient.match.get(matchId, "AMERICAS");

// Get ranked data by PUUID
const leagues = await riotClient.league.byPuuid(
  puuid,
  "NA1", // PlatformRoute
);

Sources

Files

Just SKILL.md in packages/dotfiles/dot_agents/skills/lol-helper of shepherdjerred/monorepo.

Open the folder on GitHubat commit bc57ca5

Compare with similar skills

Lol Helper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lol Helper compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Lol Helper this skillshepherdjerred/monorepo	112	—	~6.7k	Automated safety check: Pass	GPL-3.0	today
API Gatewayitsmostafa/aws-agent-skills	1.2k	—	~2.2k	Automated safety check: Pass	MIT	3 days ago
API Referencematrixorigin/memoria	609	—	~2.3k	Automated safety check: Pass	Apache-2.0	today
API Auditbriiirussell/cybersecurity-skills	413	—	~2.8k	Automated safety check: Notes	MIT	4 mo ago
Ops Indexer Queryboundless-xyz/boundless	193	—	~3.5k	Automated safety check: Pass	Apache-2.0	1 mo ago
Apikerhodgef/apiker	127	—	~1.4k	Automated safety check: Pass	MIT	1 mo ago

Similar skills

API Gateway
itsmostafa/aws-agent-skills
AWS API Gateway for REST and HTTP API management. An agent skill from itsmostafa/aws-agent-skills.
1.2k GitHub stars~2.2k tokensUpdated 3 days ago
Backend & APIsAuto-check passed
API Reference
matrixorigin/memoria
Memoria REST API endpoints, request/response formats, auth, rate limits.
609 GitHub stars~2.3k tokensUpdated today
Backend & APIsAuto-check passed
API Audit
briiirussell/cybersecurity-skills
Audit REST, GraphQL, and RPC APIs against the OWASP API Security Top 10 (2023).
413 GitHub stars~2.8k tokensUpdated 4 mo ago
Backend & APIsAuto-check: notes
Ops Indexer Query
boundless-xyz/boundless
Internal — for Boundless team members only. An agent skill from boundless-xyz/boundless.
193 GitHub stars~3.5k tokensUpdated 1 mo ago
Backend & APIsAuto-check passed
Apiker
hodgef/apiker
Develop, review, and extend the Apiker library — a framework for building serverless REST APIs on Cloudflare Workers + Durable Objects.
127 GitHub stars~1.4k tokensUpdated 1 mo ago
Backend & APIsAuto-check passed
Domain Web
fjrevoredo/mini-diarium
A skill your agent uses when building web services. An agent skill from fjrevoredo/mini-diarium.
308 GitHub starsUsed in 1 repo~1k tokens
Backend & APIsAuto-check passed

Questions about Lol Helper

What does Lol Helper do?

League of Legends domain knowledge, terminology, and Riot Games API reference. Lol Helper is an agent skill from shepherdjerred/monorepo. League of Legends domain knowledge, terminology, and Riot Games API reference.

When should I use Lol Helper?

Lol Helper fits situations like: working with match data; game objectives; player statistics; riot API client.

How do I install Lol Helper in Claude Code?

Run `npx skills add shepherdjerred/monorepo --skill lol-helper -a claude-code`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/lol-helper in shepherdjerred/monorepo) into .claude/skills/lol-helper in your project. Claude Code loads it when a task matches its description.

How do I install Lol Helper in Codex?

Run `npx skills add shepherdjerred/monorepo --skill lol-helper -a codex`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/lol-helper in shepherdjerred/monorepo) into .agents/skills/lol-helper in your project. Codex loads it when a task matches its description.

Can I use Lol Helper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shepherdjerred/monorepo --skill lol-helper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lol-helper, .gemini/skills/lol-helper, .github/skills/lol-helper and .opencode/skills/lol-helper in your project.

What does Lol Helper need to run?

SKILL.md names no scripts, command-line tools or credentials: Lol Helper is instructions for the agent only.

Does Lol Helper access the network?

SKILL.md names 15 domains. In commands or code: ddragon.leagueoflegends.com, na1.api.riotgames.com and americas.api.riotgames.com; the agent is likely to contact these when it follows the instructions. As links in the text: wiki.leagueoflegends.com, dignitas.gg, developer.riotgames.com, darkintaqt.com, riotgames.com, mobalytics.gg, esportsinsider.com, raw.communitydragon.org, riot-api-libraries.readthedocs.io, hextechdocs.dev, leagueoflegends.fandom.com and support-leagueoflegends.riotgames.com. This is read from the text; nothing was executed.

Is Lol Helper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lol Helper use?

Lol Helper is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lol Helper use?

About 6.7k tokens (SKILL.md is roughly 27k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Lol Helper?

Skills that share tags, products or a category with Lol Helper: API Gateway (itsmostafa/aws-agent-skills, 1.2k stars), API Reference (matrixorigin/memoria, 609 stars), API Audit (briiirussell/cybersecurity-skills, 413 stars) and Ops Indexer Query (boundless-xyz/boundless, 193 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lol Helper?

shepherdjerred (a GitHub user) maintains it in shepherdjerred/monorepo, which has 112 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 9, 2026.

Source: shepherdjerred/monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Lol Helper

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

League of Legends Helper

Part 1: Game Domain Reference

Ranked System

Tiers (Low to High)

LP (League Points)

Queue Restrictions

Queue Types

Ranked Queues

Casual Queues

Special Queues

Champion Classes

Primary Classes

Fighter Subclasses

Mage Subclasses

Assassin Subclasses

Game Objectives

Dragons (Elemental Drakes)

Elder Dragon

Baron Nashor

Rift Herald

Void Grubs

Match Statistics

Core Stats

Gold Values

Bounty System

Runes Reforged

Rune Paths

Precision Keystones

Domination Keystones

Sorcery Keystones

Resolve Keystones

Inspiration Keystones

Summoner Spells

Common Combinations

Common Terminology

Gameplay Terms

Strategic Terms

Player State Terms

Meta Terms

Match Phases

Early Game (0-15 min)

Mid Game (15-30 min)

Late Game (30+ min)

Part 2: Riot Games API Reference

API Endpoints Overview

Account-V1 (Riot ID Lookup)

Summoner-V4

Match-V5

League-V4

Champion-Mastery-V4

Spectator-V5

Challenges-V1

Regional vs Platform Routing

Platform Routing Values

Regional Routing Values

Rate Limiting

Three Types of Rate Limits

Rate Limit Headers

Error Handling

PUUID and Riot ID

Identifier Types

Recommended Workflow

Data Dragon (Static Data)

Base URLs

Common Data Files