unity-script
Create, read and analyze C# scripts
Install / Use
npx skills add Besty0728/Unity-Skills --skill scriptInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of unity-script
unity-script scores 85/100 on our quality scale, 2621st of 4,698 Development & Engineering skills we index.
Its SKILL.md is 13 KB long, well organised into 29 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so unity-script is actively maintained.
- Our last check on 2026-11-04 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unity-script compared with similar skills
All 4 of these similar skills score higher than unity-script; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-script (this skill)by Besty0728 | 85 | 1.8k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install unity-script?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-script. The install tabs above show the steps for each supported agent. - Which AI agents does unity-script work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unity-script safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is unity-script still maintained?
- The repository was last updated about 2 months ago, so unity-script is actively maintained.
Skill content
View source on GitHubname: unity-script description: Create, read and analyze C# scripts
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Authoring or editing C# code
- Searching across scripts
- Refactoring file layout
- Checking compile errors
- 编写或编辑 C# 代码、跨脚本搜索、重构文件布局、检查编译错误
Unity Script Skills
BATCH-FIRST: Use
script_create_batchwhen creating 2+ scripts. DESIGN-FIRST: Before creating gameplay scripts, actively consider coupling, performance, and maintainability. In an existing project, load../project-scout/SKILL.mdfirst. If the user is asking for architecture or refactoring advice, load../architecture/SKILL.mdand then../patterns/SKILL.md,../async/SKILL.md,../inspector/SKILL.md,../performance/SKILL.md,../script-roles/SKILL.md,../scene-contracts/SKILL.md,../testability/SKILL.md, or../scriptdesign/SKILL.mdas needed.
Operating Mode
- Approval: 只读类 skill(
script_read/script_list/script_find_in_file/script_get_info/script_get_compile_feedback,标SkillMode.SemiAuto)直接执行;本模块没有可 grant 的写型 skill —— 每一个写型 skill 都命中下一条的自动拦截,grant 只会再返一次MODE_FORBIDDEN。 - Auto / Bypass: SemiAuto 与(Bypass 下的)写型 skill 直接执行。
- 本模块全部 7 个写型 skill 都是 Delete / Reload 类高危:
script_create/script_create_batch/script_replace/script_append/script_rename/script_move/script_delete均标MayTriggerReload = true+RiskLevel = "high"(落盘 .cs 必然触发 Domain Reload),script_delete另标SkillOperation.Delete—— 这些 skill 被IsForbiddenInSemi静态拦截,在 Approval 和 Auto 下都返MODE_FORBIDDEN,仅 Bypass 或 Allowlist 命中可执行,不要尝试 grant 流程。
DO NOT (common hallucinations):
script_edit/script_updatedo not exist → usescript_replacefor find-and-replacescript_writedoes not exist → usescript_create(new file) orscript_replace(modify existing)scriptNameparameter must NOT include.csextension- Templates only accept: MonoBehaviour, ScriptableObject, Editor, EditorWindow
Routing:
- To modify existing script content →
script_replace(find/replace) orscript_append(add lines) - To read script →
script_read - To check compile errors →
script_get_compile_feedback - To analyze script API → use
perceptionmodule'sscript_analyze
Skills Overview
| Single Object | Batch Version | Use Batch When |
|---------------|---------------|----------------|
| script_create | script_create_batch | Creating 2+ scripts |
No batch needed:
script_read- Read script contentscript_list- List C# script files under a folderscript_get_info- Read class name, base class, public methods/fieldsscript_delete- Delete scriptscript_find_in_file- Search in scriptsscript_append- Append content to scriptscript_replace- Find and replace inside one script (plain text or regex)script_rename- Rename a script file in placescript_move- Move a script to another folder; a missing destination folder is created automaticallyscript_get_compile_feedback- Check compile errors for one script after Unity finishes compilingcreate_script()inscripts/unity_skills.pynow waits for Unity to come back once and refreshes compile feedback automatically after script creation.
Skills
script_create
Create a C# script from template.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scriptName | string | Yes | - | Script class name |
| folder | string | No | "Assets/Scripts" | Save folder |
| template | string | No | "MonoBehaviour" | Template type |
| namespaceName | string | No | null | Optional namespace |
| checkCompile | bool | No | true | Check compilation after create |
| diagnosticLimit | int | No | 20 | Max compile diagnostics |
Templates: MonoBehaviour, ScriptableObject, Editor, EditorWindow
Returns: {success, status, path, jobId, className, namespaceName, designReminder, serverAvailability?}
Poll the returned jobId (or call script_get_compile_feedback) to obtain compile diagnostics — they are not embedded in the synchronous response. serverAvailability carries the transient-unavailable hint when Unity is about to reload the script domain.
script_create_batch
Create multiple scripts in one call.
Returns: {success, totalItems, successCount, failCount, results: [{success, path, className}], compilation?}
Before batch creation, decide whether each script should be:
- a thin
MonoBehaviourbridge - a
ScriptableObjectconfiguration asset - or a plain C# domain/service class generated from a custom template
unity_skills.call_skill("script_create_batch", items=[
{"scriptName": "PlayerController", "folder": "Assets/Scripts/Player", "template": "MonoBehaviour"},
{"scriptName": "EnemyAI", "folder": "Assets/Scripts/Enemy", "template": "MonoBehaviour"},
{"scriptName": "GameSettings", "folder": "Assets/Scripts/Data", "template": "ScriptableObject"}
])
script_read
Read script content.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| scriptPath | string | Yes | Script asset path |
Returns: {path, lines, content}
script_delete
Delete a script.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| scriptPath | string | Yes | Script to delete |
Returns: {success, status, deleted, jobId, serverAvailability?}
script_find_in_file
Search for patterns in scripts.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| pattern | string | Yes | - | Search pattern |
| folder | string | No | "Assets" | Search folder |
| isRegex | bool | No | false | Use regex |
| limit | int | No | 50 | Max results |
Returns: {pattern, matchCount, matches: [{file, line, content}]}
script_append
Append content to a script.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scriptPath | string | Yes | - | Script path |
| content | string | Yes | - | Content to append |
| atLine | int | No | end | Line number to insert at |
| checkCompile | bool | No | true | Check compilation after append |
| diagnosticLimit | int | No | 20 | Max compile diagnostics |
script_get_compile_feedback
Get compile diagnostics related to one script.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scriptPath | string | Yes | - | Script path |
| limit | int | No | 20 | Max diagnostics |
Example: Efficient Script Setup
import unity_skills
# BAD: 3 API calls + 3 Domain Reloads
unity_skills.call_skill("script_create", scriptName="PlayerController", folder="Assets/Scripts/Player")
# Wait for Domain Reload...
unity_skills.call_skill("script_create", scriptName="EnemyAI", folder="Assets/Scripts/Enemy")
# Wait for Domain Reload...
unity_skills.call_skill("script_create", scriptName="GameManager", folder="Assets/Scripts/Core")
# Wait for Domain Reload...
# GOOD: 1 API call + 1 Domain Reload
unity_skills.call_skill("script_create_batch", items=[
{"scriptName": "PlayerController", "folder": "Assets/Scripts/Player"},
{"scriptName": "EnemyAI", "folder": "Assets/Scripts/Enemy"},
{"scriptName": "GameManager", "folder": "Assets/Scripts/Core"}
])
# Wait for Domain Reload once...
Important: Domain Reload And Compile Feedback
After creating or editing scripts, Unity triggers a Domain Reload (recompilation). Use the returned compilation field first. If isCompiling=true, wait for Unity to finish and then call script_get_compile_feedback.
import time
result = unity_skills.call_skill("script_create", scriptName="MyScript")
time.sleep(5) # Wait for Unity to recompile if result["compilation"]["isCompiling"] is true
feedback = unity_skills.call_skill("script_get_compile_feedback", scriptPath=result["path"])
unity_skills.call_skill("component_add", name="Player", componentType="MyScript")
Best Practices
- Use meaningful script names matching class name
- Organize scripts in logical folders
- Before creating gameplay code, decide the class role first: MonoBehaviour, ScriptableObject, or plain C# helper/service
- Actively reduce coupling: prefer explicit dependencies, small responsibilities, and event-driven notifications over hidden globals
- Actively consider performance: avoid unnecessary
Update, repeatedFind, reflection in hot paths, and avoidable allocations - Actively consider maintainability: clear naming, explicit ownership, Inspector-friendly fields, and simple module boundaries
- Avoid giant boilerplate/template dumps. Start from the smallest structure that solves the current need
- Do not default to UniTask or a global event bus unless the project context justifies them
- Avoid cryptic abbreviations in class, field, and method names unless they are already a project convention
- Use templates for correct base class
- Wait for compilation after creating scripts
- After script edits, call
script_get_compile_feedbackand fix reported errors - Use regex search for complex patterns
- Use batch creation to minimize Domain Reloads
Additional Skills
script_replace
Find and replace content in a script file.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scriptPath | string | Yes | - | Script asset path |
| find | string | Yes | - | Text or pattern to find |
| replace | string | Yes | - | Replacement text |
| isRegex | bool | No | false | Use regex matching |
| checkCompile | bool | No | true | Check compilation after replace |
| diagnosticLimit | int | No | 20 | Max compile diagnostics |
Returns: { success, status, path, jobId, replacements, serverAvailability? }
script_list
List C# script files in the project.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| folder | string | No | "Assets" | Folder to search in |
| filter | string | No | null | Filter string for path matching |
| limit | int | No | 100 | Max results |
Returns: { count, scripts: [{ path, name }] }
script_get_info
Get script info (class name, base class, methods).
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scriptPath | string | Yes | - | Script asset path |
Returns: { path, className, baseClass, namespaceName, isMonoBehaviour, publicMethods, publicFields }
script_rename
Rename a script file.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scriptPath | string | Yes | - | Script asset path |
| newName | string | Yes | - | New script name (without extension) |
| checkCompile | bool | No | true | Check compilation after rename |
| diagnosticLimit | int | No | 20 | Max compile diagnostics |
Returns: { success, status, path, jobId, oldPath, newName, serverAvailability? }
script_move
Move a script to a new folder.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scriptPath | string | Yes | - | Script asset path |
| newFolder | string | Yes | - | Destination folder. Created (and registered in AssetDatabase) automatically if missing. |
| checkCompile | bool | No | true | Check compilation after move |
| diagnosticLimit | int | No | 20 | Max compile diagnostics |
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
