foundry-vtt-module-dev

Develop custom Foundry Virtual Tabletop modules with JavaScript and the Foundry API.

17|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/fcsouza/agent-skills --skill foundry-vtt-module-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foundry-vtt-module-dev
Source: https://github.com/fcsouza/agent-skills/tree/main/skills/foundry-vtt-module-dev
Command: npx skills add https://github.com/fcsouza/agent-skills --skill foundry-vtt-module-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the development process for Foundry Virtual Tabletop (FVTT) modules, enabling developers to efficiently create, extend, and maintain custom modules for their campaigns.

Core Features & Use Cases

  • Module Scaffolding: Provides a structured approach to building new FVTT modules from scratch.
  • Custom Actor & Item Types: Guide on creating and registering custom Actor and Item types.
  • Application Framework: Covers the Application Framework (v2) for creating interactive UI components like sheets, dialogs, and forms.
  • Hooks & Settings: Explains how to use hooks for event handling and settings for module configuration.
  • Canvas Extensions: Instructions on extending the FVTT canvas with custom layers and placeable objects.
  • Advanced Patterns: Dive into advanced topics like sockets, dice rolls, compendium packs, and localization.
  • Developer Tooling: Overview of tools like the official CLI, TypeScript, build tools, and reactive frameworks.
  • Publishing: Guide on packaging and submitting modules to the Foundry platform.
  • Testing: Introduces the Quench testing framework for in-game testing.
  • Community Libraries: Overview of useful community libraries like libWrapper and socketlib.
  • Module API Pattern: Best practices for exposing a public API for interaction with other modules.
  • Debugging: Tips on using browser DevTools, logging, and the Developer Mode module.
  • Active Effects: Guide on using ActiveEffects for temporary modifications to document data.
  • Adventure Documents: Detailed explanation of creating and managing Adventure documents for campaign content.
  • Permissions & Ownership: Overview of the permission model and ownership handling in Foundry.
  • Migration & Maintenance: Tips on handling migrations and maintaining modules across Foundry versions.
  • Boilerplate Files: List of boilerplate files provided to kickstart module development.

Quick Start

Use the foundry-vtt-module-dev skill to scaffold a new module. Run 'foundry-vtt-module-dev init' to create a new module folder with the necessary structure and files.

Frequently Asked Questions about foundry-vtt-module-dev

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

FAQPage Schema
How do I scaffold a new Foundry VTT module from scratch?

To scaffold a Foundry VTT module, run the initialization command to automatically generate a new module folder with the necessary structure and boilerplate files. This provides a structured starting point for developing custom modules for your campaigns.

How do I create custom UI components using the Foundry Application Framework?

The Foundry Application Framework (v2) enables creating interactive UI components like sheets, dialogs, and forms for custom modules. This Skill provides implementation guidance for building these interfaces while maintaining performance and modularity best practices.

What JavaScript proficiency is required for Foundry VTT module development?

Foundry VTT module development requires solid JavaScript proficiency and understanding of the Foundry API. This Skill is designed for developers with these prerequisites, focusing on advanced implementation patterns rather than introductory JavaScript concepts.

How do I use hooks and settings for Foundry module configuration?

Foundry hooks enable event handling while settings provide module configuration capabilities. This Skill explains how to implement both features, allowing your custom module to respond to game events and offer configurable options to users.

How do I test Foundry VTT modules using the Quench framework?

The Quench testing framework enables in-game testing of Foundry VTT modules. This Skill introduces how to implement Quench tests to validate your module's functionality, ensuring reliability before publishing to the Foundry platform.

How do I handle module migration and maintenance across Foundry versions?

Module migration and maintenance across Foundry versions requires following specific patterns to handle breaking changes. This Skill provides tips on managing migrations and maintaining modules to ensure continued compatibility with the platform.