rewards-module-builder

Automate end-to-end development of the TogetherOS Rewards module.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/coopeverything/TogetherOS --skill rewards-module-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rewards-module-builder
Source: https://github.com/coopeverything/TogetherOS/tree/main/docs/skills/rewards-module
Command: npx skills add https://github.com/coopeverything/TogetherOS --skill rewards-module-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the complex process of developing gamification features for TogetherOS, such as badges, skill trees, and visual progression. It ensures consistent architecture and reduces the manual effort involved in creating entity models, API handlers, UI components, and tests across the module.

Core Features & Use Cases

  • Full-Stack Module Development: Automates the creation of domain models, data repositories, API endpoints, UI components, and unit tests for reward features.
  • Architectural Consistency: Enforces TogetherOS's domain-driven architecture, ensuring new reward features integrate seamlessly.
  • Comprehensive Documentation: Guides the update of module specifications, data models, and progress tracking, keeping the project documentation current.
  • Use Case: When tasked with adding a new "Community Heart" badge that unlocks specific capabilities, this Skill will guide and automate the creation of all necessary code artifacts, from the database entity to the frontend display, and ensure all related documentation is updated.

Quick Start

To define a new 'First Mutual Aid' badge for the 'community_heart' path: Use Skill: rewards-module-builder Inputs: reward_type: badge name: 'First Mutual Aid' description: 'Awarded for completing your first mutual aid transaction.' icon: '🤝' path: 'community_heart' criteria: { type: 'mutual_aid_count', threshold: 1 }

Frequently Asked Questions about rewards-module-builder

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

FAQPage Schema
How do I build gamification features like badges and skill trees for TogetherOS?

The rewards-module-builder automates end-to-end development of gamification features, generating domain models, repositories, API endpoints, UI components, and tests. It enforces domain-driven architecture to ensure consistent integration across your full stack.

Can I create custom reward types with validation logic and UI components?

Yes. This Skill automates creation of new reward types by implementing domain entities, validators, repositories, API handlers, and frontend components. You define criteria and the Skill generates type-safe schemas and wires rewards to member actions across all layers.

What's included when I add a new badge to TogetherOS?

Adding a badge generates the complete artifact chain: entity models, in-memory test repositories, API handlers, UI components, unit tests, and updated documentation. The Skill ensures all components integrate seamlessly with existing TogetherOS architecture.

Do I need to write separate code for domain logic, API endpoints, and frontend UI?

The Skill automates this entire workflow, reducing manual effort. It generates repositories, API handlers, validators, fixtures, and UI components in one process, maintaining architectural consistency so you don't repeat patterns across layers.

How does this approach keep module documentation current?

The Skill guides comprehensive documentation updates alongside code generation, keeping module specifications, data models, and progress tracking synchronized. This prevents documentation drift as reward features scale.