swerpg-talent-effects

Model, validate, and project SWERPG Talent effects for Foundry VTT.

1|Updated Mar 15, 2025
One-click install
npx skills add https://github.com/herveDarritchon/foundryvtt-swerpg --skill swerpg-talent-effects
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swerpg-talent-effects
Source: https://github.com/herveDarritchon/foundryvtt-swerpg/tree/main/.agents/skills/swerpg-talent-effects
Command: npx skills add https://github.com/herveDarritchon/foundryvtt-swerpg --skill swerpg-talent-effects

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires vitest, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill creates a unified, reliable model to implement, validate, and extend the effects and actions associated with Talents in the SWERPG system for Foundry VTT, ensuring consistency and correctness across workflows.

Core Features & Use Cases

  • Effect and Action Data Modeling: Defines a comprehensive schema for Talent effects and actions, including validation and defaulting rules.
  • Validation and Traceability: Implements runtime validators and mapping traceability for effects imported from external sources like OggDude.
  • ActiveEffect Integration: Bridges Talent effects with Foundry's ActiveEffect system to support dynamic, optional projections.
  • Effect Filtering: Provides effect collection functions to identify applicable effects based on timing, scope, and conditions.
  • Automation and UI: Supports automation levels and assists in effect application decisions, enhancing user experience during gameplay and development.
  • Consistent Architecture: Ensures separation of business logic (system.effects) from technical projections (ActiveEffect) for clarity and maintainability.

Quick Start

Use the effect modeling utilities to define, validate, and project Talent effects as part of your SWERPG character system in Foundry. First, establish effect schemas, then create effects following the defined contracts, validating with provided functions during development.

Frequently Asked Questions about swerpg-talent-effects

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

FAQPage Schema
How do I standardize talent effects in a Foundry VTT system?

Standardize talent effects in Foundry VTT by defining a comprehensive schema for effects and actions, implementing runtime validators, and separating business logic from technical ActiveEffect projections to ensure consistency across workflows.

How do I validate imported talent effects from external sources in Foundry VTT?

Validate imported talent effects in Foundry VTT using runtime validators and mapping traceability functions that check imported data against the standardized effect schema, ensuring correctness for data brought in from external sources like OggDude.

Can I project talent effects to Foundry ActiveEffects dynamically?

Project talent effects to Foundry ActiveEffects dynamically by using the optional integration bridge, which connects the defined system effects with Foundry's ActiveEffect system to support dynamic projections during gameplay.

What is the best way to filter applicable talent effects during gameplay in Foundry VTT?

Filter applicable talent effects in Foundry VTT using built-in collection functions that identify relevant effects based on timing, scope, and conditions, assisting in effect application decisions and automation levels during gameplay.

Do I need vitest to develop talent effect models for SWERPG Foundry VTT?

Vitest is required as the testing dependency to validate talent effect models and actions for SWERPG Foundry VTT, ensuring the schema definitions, validation rules, and effect mappings function correctly during development.

Why separate business logic from ActiveEffect projections in Foundry VTT?

Separating business logic from ActiveEffect projections in Foundry VTT ensures architectural clarity and maintainability, keeping the core system effects distinct from technical Foundry-specific projections for reliable effect management.