New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Achievements System

by OpenLitterMap in OpenLitterMap/openlittermap-web

AchievementEngine, AchievementRepository, milestone checkers, AchievementsSeeder, userachievements pivot, AchievementsController API, and achievement evaluation flow.

GPL-3.0Auto-check passedProduct & Project Management

Install Achievements System

skills CLI
$ npx skills add OpenLitterMap/openlittermap-web --skill achievements-system -a claude-code

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

GitHub CLI
$ gh skill install OpenLitterMap/openlittermap-web achievements-system --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/OpenLitterMap/openlittermap-web.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.ai/skills/achievements-system .claude/skills/achievements-system && 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/

Facts

Skill name
achievements-system
GitHub stars
134
Token cost
~1.4k tokens
SKILL.md length
415 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
GPL-3.0

At a glance

AchievementEngine, AchievementRepository, milestone checkers, AchievementsSeeder, userachievements pivot, AchievementsController API, and achievement evaluation flow.

  • Works in 6 steps: Achievements are evaluated after Redis… → Definitions are seeded, not… → user_achievements pivot has composite PK… → …
  • Tasks that involve Project management
  • SKILL.md covers Key Files, Invariants, Architecture and Achievement Types, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Achievements System is an agent skill from OpenLitterMap/openlittermap-web. AchievementEngine, AchievementRepository, milestone checkers, AchievementsSeeder, userachievements pivot, AchievementsController API, and achievement evaluation flow.

Its SKILL.md is about 1.4k 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 Product & Project Management, covering Project management. It works with PHP. The repository describes itself as: https://opengeospatialdata.springeropen.com/articles/10.1186/s40965-018-0050-y. The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Project management

Example prompts

  • “/achievements-system”

Workflow steps

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

  1. Achievements are evaluated after Redis metrics update. AchievementEngine::evaluate() reads from RedisMetricsCollector::getUserMetrics()…
  2. Definitions are seeded, not runtime-created. AchievementsSeeder creates all definition rows. Adding a new tag type or milestone requires…
  3. user_achievements pivot has composite PK (user_id, achievement_id). insertOrIgnore prevents duplicates.
  4. Checkers use early-exit optimization. Achievements sorted by threshold ascending — once a threshold isn't met, remaining are skipped.
  5. Fallback pass in engine catches checker gaps. meetsThreshold() runs after all checkers, catching anything they missed (safety net for…
  6. Caching: Definitions cached 24h (achievements.all), per-user unlocked cached 5m (user.achievements.$userId). Cache cleared on unlock.

What it can do on your machine

Read from SKILL.md and the folder at commit ac688aa. 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.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Achievements System loads about 1.4k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 415 words of instructions outside code blocks.

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

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 OpenLitterMap/openlittermap-web at commit ac688aa, republished under its GPL-3.0 licence (© OpenLitterMap). 415 words, ~1,396 tokens.

Download SKILL.mdSave it as .claude/skills/achievements-system/SKILL.md (or your agent's skills folder).
name
achievements-system
description
AchievementEngine, AchievementRepository, milestone checkers, AchievementsSeeder, user_achievements pivot, AchievementsController API, and achievement evaluation flow.

Achievements System

Milestone-based achievements unlocked when users hit thresholds for uploads, streaks, and per-tag counts. Definitions are seeded from config/achievements.php milestones crossed with every tag in the system.

Key Files

  • config/achievements.php — Milestones array, cache TTL, level thresholds
  • app/Services/Achievements/AchievementEngine.php — Core evaluator (checkers + fallback pass)
  • app/Services/Achievements/AchievementRepository.php — DB reads/writes + caching
  • app/Services/Achievements/Checkers/AchievementChecker.php — Abstract base checker
  • app/Services/Achievements/Checkers/UploadsChecker.php — Uploads dimension
  • app/Services/Achievements/Checkers/ObjectsChecker.php — Objects dimension + per-object
  • app/Services/Achievements/Checkers/CategoriesChecker.php — Categories dimension + per-category
  • app/Services/Achievements/Checkers/MaterialsChecker.php — Materials (extends OptimizedTagBasedChecker)
  • app/Services/Achievements/Checkers/BrandsChecker.php — Brands (extends OptimizedTagBasedChecker)
  • app/Services/Achievements/Checkers/CustomTagChecker.php — Custom tags (extends OptimizedTagBasedChecker)
  • app/Services/Achievements/Checkers/OptimizedTagBasedChecker.php — Abstract base for tag-based checkers
  • app/Services/Achievements/Tags/TagKeyCache.php — Tag key-to-ID resolution cache
  • app/Providers/AchievementServiceProvider.php — DI wiring (engine, repository, checkers)
  • app/Models/Achievements/Achievement.php — Eloquent model
  • app/Events/AchievementsUnlocked.php — Event fired when achievements unlock
  • app/Http/Controllers/Achievements/AchievementsController.php — API endpoint
  • database/seeds/AchievementSeeder.php — Seeds achievement definitions
  • database/factories/AchievementFactory.php — Test factory
  • tests/Feature/Achievements/AchievementEngineTest.php — Engine integration tests
  • tests/Feature/Achievements/LongTermAchievementsTest.php — Long-term achievement tests
  • tests/Unit/Achievements/CheckerUnitTest.php — Checker unit tests

Invariants

  1. Achievements are evaluated after Redis metrics update. AchievementEngine::evaluate() reads from RedisMetricsCollector::getUserMetrics(). Redis must be updated first.
  2. Definitions are seeded, not runtime-created. AchievementsSeeder creates all definition rows. Adding a new tag type or milestone requires rerunning the seeder.
  3. user_achievements pivot has composite PK (user_id, achievement_id). insertOrIgnore prevents duplicates.
  4. Checkers use early-exit optimization. Achievements sorted by threshold ascending — once a threshold isn't met, remaining are skipped.
  5. Fallback pass in engine catches checker gaps. meetsThreshold() runs after all checkers, catching anything they missed (safety net for off-by-one or unregistered checkers).
  6. Caching: Definitions cached 24h (achievements.all), per-user unlocked cached 5m (user.achievements.$userId). Cache cleared on unlock.

Architecture

Photo tagged + verified
  → TagsVerifiedByAdmin event
    → ProcessPhotoMetrics listener
      → MetricsService::processPhoto() (MySQL + Redis)
      → EvaluateUserAchievements job (queued)
        → AchievementEngine::evaluate($userId)
          → RedisMetricsCollector::getUserMetrics($userId)
          → Run all registered checkers
          → Fallback meetsThreshold() pass
          → AchievementRepository::unlockAchievements()
          → Cache invalidation
Show full SKILL.md (183 more words)Show less

Achievement Types

TypeScopeExample
uploadsDimension-wide (no tag_id)"Upload 42 photos"
streakDimension-wide (no tag_id)"7-day upload streak"
objectsDimension-wide (no tag_id)"Tag 1000 total objects"
objectPer-tag (tag_id = litter_object.id)"Tag 69 cigarette butts"
categoriesDimension-wide (no tag_id)"Tag items in 10 categories"
categoryPer-tag (tag_id = category.id)"Tag 256 smoking items"
materialsDimension-wide (no tag_id)"Tag 500 total materials"
materialPer-tag (tag_id = material.id)"Tag 42 plastic items"
brandsDimension-wide (no tag_id)"Tag 100 total brands"
brandPer-tag (tag_id = brand.id)"Tag 69 Coca-Cola items"
customTagPer-tag (tag_id = custom_tag.id)Per custom tag milestones

Milestones

From config/achievements.php:

[1, 42, 69, 256, 360, 404, 420, 451, 512, 666, 777, 1337, 2048, 3333, 3600, 9001, 13337, 42069, 69420, 133337, 420420, 666666, 696969, 4206969]

Each milestone is crossed with each type/tag combination, producing ~222k achievement definitions.

API

GET /api/achievements (auth required) — Returns hierarchical JSON:

  • overview: progress for uploads, streak, total_categories, total_objects
  • categories: per-category with nested per-object progress
  • summary: total/unlocked/percentage

Common Mistakes

  • Evaluating before Redis is updated. getUserMetrics() reads from Redis. If called before RedisMetricsCollector::processPhoto(), counts are stale.
  • Forgetting to reseed after adding tags. New LitterObjects/Materials/Brands need new achievement definition rows.
  • Assuming checkers cover all types. The fallback meetsThreshold() is the safety net. If a checker is missing, achievements still unlock (just slower).

© OpenLitterMap, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .ai/skills/achievements-system of OpenLitterMap/openlittermap-web.

Open the folder on GitHubat commit ac688aa

Compare with similar skills

Achievements System 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.

Achievements System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Achievements System this skillOpenLitterMap/openlittermap-web134—~1.4kAutomated safety check: PassGPL-3.0
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Uvastral-sh/claude-code-plugins3132 repos~980Automated safety check: PassApache-2.0
Project Managementkunchenguid/firstmate7.7k—~2.1kAutomated safety check: PassMIT
Hivemind Goalsactiveloopai/hivemind1.6k—~1.7kAutomated safety check: NotesApache-2.0
Ichartjswanghetommy/ichartjs352—~4.3kAutomated safety check: PassApache-2.0

Similar skills

  • CCPM Project Management

    automazeio/ccpm

    Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed

  • Uv

    astral-sh/claude-code-plugins

    Official

    Guide for using uv, the Python package and project manager. An agent skill from astral-sh/claude-code-plugins.

    313 GitHub starsUsed in 2 repos~980 tokens
    Product & Project ManagementAuto-check passed

  • Project Management

    kunchenguid/firstmate

    Agent-only procedure for Firstmate project management. An agent skill from kunchenguid/firstmate.

    7.7k GitHub stars~2.1k tokensUpdated today
    Product & Project ManagementAuto-check passed

  • Hivemind Goals

    activeloopai/hivemind

    Create, track and update team goals via the Deeplake virtual filesystem at memory/goal/.

    1.6k GitHub stars~1.7k tokensUpdated 11 days ago
    Product & Project ManagementAuto-check: notes

  • Ichartjs

    wanghetommy/ichartjs

    Plan, validate, render, explain, and safely edit iChart.js visualizations from tabular, project, or diagram data.

    352 GitHub stars~4.3k tokensUpdated today
    Product & Project ManagementAuto-check passed

  • Hivemind Goals

    activeloopai/hivemind

    Create, track and update team goals in Hivemind via the hivemind CLI.

    1.6k GitHub stars~814 tokensUpdated 11 days ago
    Product & Project ManagementAuto-check passed

More from OpenLitterMap/openlittermap-web

All 16 skills in this repo

  • Tailwindcss Development

    OpenLitterMap/openlittermap-web

    Styles applications using Tailwind CSS v3 utilities. An agent skill from OpenLitterMap/openlittermap-web.

    134 GitHub stars~713 tokensUpdated 24 days ago
    Auto-check passed

  • Olm Architecture

    OpenLitterMap/openlittermap-web

    OpenLitterMap v5 architecture reference. An agent skill from OpenLitterMap/openlittermap-web.

    134 GitHub stars~5.2k tokensUpdated 24 days ago
    Auto-check passed

  • Admin System

    OpenLitterMap/openlittermap-web

    AdminController, photo approval, tag editing, deletion, MetricsService integration, admin middleware, verification queue, and admin XP.

    134 GitHub stars~3.9k tokensUpdated 24 days ago
    Auto-check passed

  • API Endpoints

    OpenLitterMap/openlittermap-web

    REST API endpoints, route structure, auth guards, request/response contracts, error patterns, and the full API surface for web SPA and mobile clients.

    134 GitHub stars~4k tokensUpdated 24 days ago
    Auto-check passed

  • Clustering System

    OpenLitterMap/openlittermap-web

    ClusteringService, tile keys, dirty tiles/teams, clustering commands, ClusterController GeoJSON API, PhotoObserver dirty marking, and map cluster rendering.

    134 GitHub stars~2k tokensUpdated 24 days ago
    Auto-check passed

  • Leaderboard System

    OpenLitterMap/openlittermap-web

    LeaderboardController, Redis sorted sets for all-time XP rankings, per-user metrics rows for time-filtered rankings, rewardXpToAdmin, and leaderboard privacy.

    134 GitHub stars~2k tokensUpdated 24 days ago
    Auto-check passed

Works with

Categories

Questions about Achievements System

What does Achievements System do?

AchievementEngine, AchievementRepository, milestone checkers, AchievementsSeeder, userachievements pivot, AchievementsController API, and achievement evaluation flow. Achievements System is an agent skill from OpenLitterMap/openlittermap-web. AchievementEngine, AchievementRepository, milestone checkers, AchievementsSeeder, userachievements pivot, AchievementsController API, and achievement evaluation flow.

When should I use Achievements System?

Achievements System fits situations like: tasks that involve Project management.

How do I install Achievements System in Claude Code?

Run `npx skills add OpenLitterMap/openlittermap-web --skill achievements-system -a claude-code`. Or copy the skill folder (.ai/skills/achievements-system in OpenLitterMap/openlittermap-web) into .claude/skills/achievements-system in your project. Claude Code loads it when a task matches its description.

How do I install Achievements System in Codex?

Run `npx skills add OpenLitterMap/openlittermap-web --skill achievements-system -a codex`. Or copy the skill folder (.ai/skills/achievements-system in OpenLitterMap/openlittermap-web) into .agents/skills/achievements-system in your project. Codex loads it when a task matches its description.

Can I use Achievements System 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 OpenLitterMap/openlittermap-web --skill achievements-system -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/achievements-system, .gemini/skills/achievements-system, .github/skills/achievements-system and .opencode/skills/achievements-system in your project.

What does Achievements System need to run?

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

Does Achievements System access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Achievements System 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 Achievements System use?

Achievements System 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 Achievements System use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Achievements System?

Skills that share tags, products or a category with Achievements System: CCPM Project Management (automazeio/ccpm, 8.4k stars), Uv (astral-sh/claude-code-plugins, 313 stars), Project Management (kunchenguid/firstmate, 7.7k stars) and Hivemind Goals (activeloopai/hivemind, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Achievements System?

OpenLitterMap (a GitHub organization) maintains it in OpenLitterMap/openlittermap-web, which has 134 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 14, 2026.

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