ashexplained/roblox-skills

setup-roblox-skills

Bootstrap the Roblox skill pack in a game project by injecting a Roblox Skills block into CLAUDE.md — the full game-development lifecycle map, every skill's purpose, use case, and trigger words, and the next-skill routing so each skill ends by telling the u…

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/ashexplained/roblox-skills --skill setup-roblox-skills

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Setup Roblox Skills

Wire the Roblox skill pack into a specific game project so every skill knows the lifecycle, its neighbors, and where this project tracks work — and so each skill ends by suggesting what to run next.

This is a prompt-driven skill, not a script. Explore, ask a few short questions, confirm, then write.

The tracker is for planning, not code. The game's Luau code and instances live in the Roblox cloud experience and are edited through Studio MCP (roblox-studio-workflow) — never committed to Git. Git / the tracker holds only planning artifacts: ROADMAP.md, PRDs, slices, and UI design briefs. Make this explicit when setting up.

What it writes

  1. A `## Roblox Skills` block in the project's CLAUDE.md, containing:
  • the game-development lifecycle map (phases → which skills run in each),
  • the skill catalog — every skill's one-line purpose, use when, and trigger words,
  • the next-skill routing convention: at the end of any skill, tell the user which skill to run next.

The canonical block is claude-block.md — inject it verbatim (trimming any skill folders this project doesn't have installed).

  1. docs/agents/ config files: the tracker, the triage labels, and the UI design artifact layout.

Process

1. Explore

Read what already exists — don't assume:

  • git remote -v — is this game project a GitHub repo?
  • CLAUDE.md at the root — does it exist? Is there already a ## Roblox Skills block?
  • ROADMAP.md, roadmap/, .roblox/ — is a local roadmap/tracker convention already in use?
  • docs/agents/ — did a prior run already write config?
  • design/ — do any UI design briefs already exist?

2. Ask (one at a time)

Assume the user may be new to this. Give a one-line explainer, then the choices and the default.

A — Where is work tracked? Slices from roblox-to-issues and bugs from roblox-triage need a home.

  • Local roadmap (default, Studio-first) — ROADMAP.md as the index plus markdown files under roadmap/<feature-slug>/. Best for solo devs working in Studio without a Git remote. Seed from tracker-local.md.
  • GitHub issues — issues live in the project's GitHub repo via the gh CLI. Propose this if a GitHub remote exists. Seed from tracker-github.md.
  • Other (Trello, Notion, etc.) — the user describes it in a sentence; record as prose.

B — Triage labels. The five canonical states (needs-triage, needs-info, ready-to-build, needs-human, wontfix) plus categories (bug, enhancement). Defaults equal their names; ask only if the user already uses different strings. Seed from triage-labels.md.

C — UI design artifacts. UI slices can't be built until an approved design brief exists (see roblox-game-ux). Confirm the layout (default: markdown briefs under design/features/<feature-slug>/, optionally with reference images/screenshots — Roblox UI is built in Studio, so these are specs, not HTML stylekits). Seed from design-artifacts.md.

3. Confirm

Show the user a draft of the ## Roblox Skills block and the docs/agents/*.md files. Let them edit before writing.

4. Write

  • If CLAUDE.md exists, edit it; if not, ask before creating one (don't also create AGENTS.md if the user prefers that — edit whichever they choose).
  • If a ## Roblox Skills block already exists, update it in place — don't append a duplicate, and don't clobber surrounding sections.
  • Inject the block from claude-block.md. Omit any skill whose folder isn't installed here rather than inventing it.
  • Write docs/agents/tracker.md, docs/agents/triage-labels.md, and docs/agents/design.md from the chosen seed files.

5. Done

Tell the user setup is complete, that every Roblox skill will now read this block for lifecycle and routing, and that they can edit docs/agents/*.md later without re-running this skill.

Next

Start (or resume) the game with `roblox-game-development-lifecycle`, which reads this block to find the current phase and route to the right specialist. For a brand-new game, go to `roblox-game-ideas`.

来自同一仓库

更多 Skills

全部 Skills
ashexplained
社区

roblox-playtest-qa

Playtest Roblox experiences through Studio MCP with attention to first-session fun, mobile UX, console errors, progression, social hooks, performance, and exploit-sensitive flows.

1小时安装量
4
GitHub Stars
63
最近更新
7月1日
ashexplained
社区

roblox-animation-audio-feedback

Improve Roblox feel through animation, audio, VFX, haptics-like feedback, reward juice, movement feel, combat feedback, UI transitions, emotes, and satisfying loop feedback without hurting mobile performance.

1小时安装量
3
GitHub Stars
63
最近更新
7月1日
ashexplained
社区

roblox-combat-systems

Design, implement, and review Roblox combat systems. Use for melee, ranged, abilities, cooldowns, hit detection, damage validation, status effects, enemy AI hooks, combat UI, balance knobs, VFX/SFX, and exploit-resistant remotes.

1小时安装量
3
GitHub Stars
63
最近更新
7月1日
ashexplained
社区

roblox-creator-store-security-audit

Audit Roblox Creator Store, Toolbox, inventory, group, universe, package, model, UI, gameplay, plugin-like, and other third-party imported assets for malicious or risky scripts. Use whenever Claude imports, inserts, reviews, or trusts Creator Store assets, especially assets with Scripts, LocalScripts, ModuleScripts, hidden descendants, require calls, HTTP, DataStore, remote creation, obfuscated code, or suspicious names.

1小时安装量
3
GitHub Stars
63
最近更新
7月1日