achievements-system

Evaluate uploads, streaks, and per-tag counts against seeded thresholds.

132|42|Updated Aug 19, 2020
One-click install
npx skills add https://github.com/OpenLitterMap/openlittermap-web --skill achievements-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: achievements-system
Source: https://github.com/OpenLitterMap/openlittermap-web/tree/main/.ai/skills/achievements-system
Command: npx skills add https://github.com/OpenLitterMap/openlittermap-web --skill achievements-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates recognition of user milestones by monitoring uploads, streaks, and per-tag activity, turning raw interactions into visible progress and rewards.

Core Features & Use Cases

  • Seeded milestone definitions are stored in config/achievements.php and evaluated against real user activity.
  • Core evaluator engine with multiple checkers detects when thresholds are crossed.
  • API endpoints expose user achievements and progress, enabling dashboards and gamification.
  • Event-driven unlocks and caching improve performance and responsiveness.

Quick Start

Seed the definitions and run a sample workflow to observe milestones unlock in real time.

Frequently Asked Questions about achievements-system

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

FAQPage Schema
How do I track user milestones and unlock achievements in a Laravel application?

To track user milestones in Laravel, you evaluate uploads, streaks, and per-tag counts against seeded thresholds defined in config/achievements.php. The engine uses multiple checkers and event-driven unlocks to automate gamified progress and rewards.

How does gamification milestone tracking work with Redis caching?

Redis caching improves performance by storing evaluated milestone states, while event-driven unlocks detect when thresholds are crossed. This ensures responsive API-driven dashboards and leaderboards without repeatedly querying the database for user activity.

Can I expose user achievement progress through an API for frontend dashboards?

API endpoints expose user achievements and progress, enabling gamified dashboards and product analytics. The engine evaluates real user activity against seeded definitions and delivers results directly through the API layer.

What is the best way to define custom achievement thresholds in a gamification engine?

The best way to define custom thresholds is by seeding milestone definitions from a configuration file. Storing criteria in config/achievements.php allows the core evaluator engine to check uploads, streaks, and per-tag counts against your specific requirements.

Does this achievements engine require specific dependencies to evaluate streaks and per-tag counts?

The engine uses Redis for caching and Laravel as its foundation. It implements core checkers to evaluate streaks and per-tag activity, requiring these environments to process event-driven unlocks and API endpoints properly.

How do I seed milestone definitions for an achievements system?

You seed milestone definitions by configuring thresholds in config/achievements.php. Once seeded, the core evaluator engine automatically monitors uploads and activity, triggering event-driven unlocks when users cross the defined boundaries.