write-angelscript

Write AngelScript code conforming to Kit API and project conventions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill write-angelscript
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-angelscript
Source: https://github.com/moraluco/Illusion-Cursor-dev-kit/tree/main/.cursor/skills/write-angelscript
Command: npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill write-angelscript

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps developers reliably write and modify AngelScript (.as) files by enforcing project conventions, guiding API lookup, and promoting a save-for-hot-reload validation workflow so changes can be tested immediately without unnecessary C++ compilation or guessing signatures.

Core Features & Use Cases

  • Local API discovery: Instructs authors to consult the Kit's content/reference/AS_API and Docs-UE-Angelscript before coding.
  • Safe fallback for missing signatures: Directs use of angelscript-api-query to verify or fetch API signatures and persist them back to local reference docs.
  • Hot-reload and testing workflow: Emphasizes saving .as files to trigger immediate reload, provides debugging and print-key guidelines, and links to TDD via angelscript-tdd-agent-iteration for automated tests.
  • Common pitfalls & conventions: Notes project-level gotchas (no #include, use value types for engine objects, FName keyed prints) and file placement/namespace expectations for Script/ files.

Quick Start

Open the Kit's content/reference/AS_API and Script-Examples to confirm signatures (use angelscript-api-query if missing), then write or edit the target .as file under Script/ and save to validate changes via hot-reload.

Frequently Asked Questions about write-angelscript

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

FAQPage Schema
How do I write AngelScript for Unreal Engine gameplay logic without triggering C++ compilation?

Save your AngelScript file to trigger an immediate hot-reload. This hot-reload workflow lets you validate gameplay logic, components, and animation instances instantly without unnecessary C++ compilation.

What's the best way to find valid AngelScript API signatures for Unreal Engine components?

Consult the local content/reference/AS_API directory for valid AngelScript API signatures. If the reference is missing, use the angelscript-api-query fallback to fetch and persist the missing signatures locally.

Can I use #include directives in Unreal Engine AngelScript files?

No, you should not use #include directives in Unreal Engine AngelScript files. You must also use value types for engine objects and apply FName keyed prints to follow project conventions and avoid common pitfalls.

How does test-driven development work with AngelScript hot-reload?

Link your AngelScript hot-reload workflow to the angelscript-tdd-agent-iteration process. This provides automated tests and validates your changes immediately after saving the .as file, enforcing a TDD workflow.

Do I need a local reference directory before writing AngelScript code?

Yes, local reference lookup under content/reference/AS_API is required before coding. You must check local docs to confirm signatures and project conventions before writing or editing your AngelScript code.