add-spell

Automate adding a new spell across definitions, scripts, VFX, loot, palette, and UI wiring.

2|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/PJensen/JSHack --skill add-spell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-spell
Source: https://github.com/PJensen/JSHack/tree/main/.agents/skills/add-spell
Command: npx skills add https://github.com/PJensen/JSHack --skill add-spell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the end-to-end process of adding a new spell to the roguelike game by coordinating definitions, scripts, VFX, loot, palette, and UI wiring.

Core Features & Use Cases

  • End-to-end spell integration workflow: define SPELL_DEFS, implement spell script, add VFX, register in loot and palette, and wire UI messages.
  • Consistent, repeatable spell extension process suitable for modders and developers.
  • Use Case: Add a new frost spell that auto-targets, applies a slow status, and drops a corresponding spellbook for players to learn.

Quick Start

Define a new spell by editing its definition, script, VFX, loot, and UI hooks across the codebase.

Frequently Asked Questions about add-spell

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

FAQPage Schema
How do I add a new spell to a roguelike game across all game systems?

Adding a new spell to a roguelike game requires updating SPELL_DEFS, spell scripts, VFX, itemCatalog, lootTables, palette, and UI wiring. This workflow automates the entire end-to-end integration process to ensure all systems are connected.

What does an end-to-end spell integration workflow include for game modding?

An end-to-end spell integration workflow includes defining spell identities, targeting rules, effects, and learning hooks. It spans editing spell definitions, implementing scripts, adding VFX, registering loot, and wiring UI messages across the codebase.

How do I validate spell frontmatter and ensure deterministic RNG when adding spells?

Validating spell frontmatter and ensuring deterministic RNG usage are enforced during the spell creation workflow. The automated process uses provided helper APIs and runs tests to verify the new spell's integration and adherence to game rules.

Can I use this workflow to add a frost spell with auto-targeting and slow status effects?

Yes, you can add a frost spell with auto-targeting and slow status effects. The workflow supports extending the spell system with new identities, custom targeting rules, specific effects, and corresponding spellbook drops for players to learn.

What tests are run when adding a new spell identity to a roguelike?

Adding a new spell identity triggers integration tests to verify the updated SPELL_DEFS, spell scripts, VFX, itemCatalog, lootTables, and palette. This ensures the new spell works correctly with existing game mechanics and helper APIs.