Skip to content
SkillModel-led2,033 tokens in use

roblox-characters

Helps an agent write Roblox character code that survives respawn: CharacterAdded scopes, Humanoid, Animator, R6 and R15 rigs, Tools and movement.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/other-engines/roblox-characters
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing roblox-characters costs

87tokens idle
2,033tokens in use
2,564tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples12/15
  • Output15/15
  • Size13/15
  • Resources7/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill helps an agent handle Roblox player characters in Luau. A Player is the durable identity and each Character is a replaceable session, so the skill keeps connections, animation tracks and temporary instances in a scope that is cleaned up on every respawn.

It includes a character-binding pattern with generation checks for stale async work, an Animator pattern with marker signals, and rules for rigs, movement ownership, the Input Action System and Tools. A table of symptoms, causes and remedies covers scripts that break after reset and handlers that fire twice.

What You Get

  • A seven-step workflow from reading the character contract to binding, defensive part lookup, movement ownership, animation lifecycle and a respawn check
  • A Luau pattern for a replaceable character scope with connection cleanup and generation checks after every yield
  • An Animator pattern that loads tracks, listens to marker signals and cleans up on teardown
  • Rules for rigs, movement, input actions, tools and Server Authority, plus a symptom, cause and remedy table

Common Use Cases

  • Fixing a script that works once and breaks after the player resets
  • Finding why animations do not play or replicate
  • Stopping sprint or dash code from fighting the Humanoid
  • Supporting both R6 and R15 rigs

What Makes It Unique

The skill frames most character bugs as one character’s state leaking into the next and answers with scopes and generation counters. It tells the agent to extend the project’s existing controller and never add a second one, and to treat animation markers as timing only, with the server validating any hit.

Under The Hood

The agent loads the SKILL.md and, when needed, a reference on server binding, death versus removal and a respawn stress matrix. It reads the project’s character settings and scripts and edits Luau files. For its lifecycle check it can use a connected Roblox Studio MCP server to start play, run Luau on the server that respawns the player several times, and read the console output; without that server it asks you to reset in Studio and report what you see. Its own sources are Roblox documentation pages, which it names for re-checking APIs; the skill does not fetch them during normal use.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers