skills.rest
Fermisloth
FermislothCOMMUNITY
Explore all skills by this author →
GitHub

assets-refresh

Refreshes the Unity AssetDatabase and forces script recompilation after external file changes.

1|Updated Apr 1, 2026
Search Tags:#game development#unity#refresh#recompilation#asset import#assetdatabase#unity-mcp-cli
One-click install
npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill assets-refresh-fermisloth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: assets-refresh
Source: https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment/tree/main/.agent/skills/assets-refresh
Command: npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill assets-refresh-fermisloth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? When files are added or modified in a Unity project outside the Unity Editor API, the AssetDatabase can become stale, causing missing assets or outdated compiled scripts. This Skill refreshes the AssetDatabase and forces recompilation of changed '.cs' files so the editor state matches the filesystem. ## Core Features & Use Cases - AssetDatabase Refresh: Synchronizes Unity's asset index with files added or updated outside the Unity API. - Forced Script Recompilation: Triggers recompilation when '.cs' files change externally, with optional import options like ForceUpdate or ForceSynchronousImport. - Use Case: After an AI agent or external tool generates new C# scripts or imports textures into the project folder, run this refresh so Unity immediately recognizes and compiles the changes. ## Quick Start Ask the AI to refresh the Unity AssetDatabase after adding new files to the project so the editor picks up the changes.

Frequently Asked Questions about assets-refresh

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

FAQPage Schema
How do I refresh the Unity AssetDatabase from the command line?▼

Run unity-mcp-cli run-tool assets-refresh with an optional JSON input specifying import options. This triggers the same refresh Unity performs in the editor, synchronizing the AssetDatabase with filesystem changes.

How to force Unity script recompilation after editing .cs files externally?▼

Invoke the assets-refresh tool after modifying '.cs' files outside the Unity API. The refresh detects the changed scripts and forces recompilation so the editor runs the latest code.

What import options does Unity AssetDatabase refresh support?▼

The options parameter accepts UnityEditor.ImportAssetOptions values: Default, ForceUpdate, ForceSynchronousImport, ImportRecursive, DontDownloadFromCacheServer, and ForceUncompressedImport. These control how assets are reimported during the refresh.

Why is unity-mcp-cli not found when running the refresh?▼

The CLI is not installed or not on your PATH. Install it globally with npm install -g unity-mcp-cli, or invoke it via npx unity-mcp-cli, then retry the assets-refresh command.

Does assets-refresh return any structured output?▼

No, the tool does not return structured output. It performs the refresh operation server-side in the Unity Editor, and success is indicated by the command completing without errors.

Related Skills

Explore More Software Engineering Skills→
AdielMagAdielMag

unity-tool-list

Lists Unity-MCP tools registered in the connected Unity Editor with optional regex filtering.

Community
Basic
DirtybitGamesDirtybitGames
15

unity-editor

Control the Unity Editor remotely via the unityctl command-line interface.

Official
Advanced
MuharremTozanMuharremTozan

unity-mcp-orchestrator

Automate Unity Editor tasks using MCP tools for scenes, scripts, and tests.

Community
Advanced
igot-aiigot-ai

assets-refresh

Refresh Unity AssetDatabase to reimport assets changed outside the Unity API.

Official
Basic