profiler-save-data

Saves a snapshot of Unity profiler stats to a JSON file.

Updated May 20, 2026
One-click install
npx skills add https://github.com/Alltwice/Unity-3D-Project --skill profiler-save-data-alltwice
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: profiler-save-data
Source: https://github.com/Alltwice/Unity-3D-Project/tree/main/.agents/skills/profiler-save-data
Command: npx skills add https://github.com/Alltwice/Unity-3D-Project --skill profiler-save-data-alltwice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Capturing a complete picture of Unity performance requires running multiple profiler queries and manually combining their results, which is slow and error-prone when diagnosing frame drops or memory issues. ## Core Features & Use Cases - Aggregated Snapshot: Composes status, memory, rendering, script, and frame capture stats into a single JSON document. - File Output: Writes the snapshot to any absolute or workspace-relative path, creating missing parent directories automatically. - Zero Dependencies: Uses only built-in Unity APIs and the .NET Base Class Library (System.Text.Json, System.IO), requiring no external packages. - Use Case: During a performance regression investigation, save a full profiler snapshot to disk so you can diff it against a baseline capture from an earlier build. ## Quick Start Save a full Unity profiler snapshot including memory, rendering, and script stats to the file profiler-snapshot.json in my workspace.

Frequently Asked Questions about profiler-save-data

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

FAQPage Schema
How do I save Unity profiler data to a JSON file?▼

Call the profiler-save-data tool with a filePath parameter pointing to an absolute or workspace-relative output path. It aggregates status, memory, rendering, script, and frame capture stats into one JSON document and writes it to disk.

What Unity profiler stats are included in the saved snapshot?▼

The snapshot composes outputs from profiler-get-status, profiler-get-memory-stats, profiler-get-rendering-stats, profiler-get-script-stats, and profiler-capture-frame into a single JSON file.

Does saving profiler data require external Unity packages?▼

No external Unity package is required. Serialization uses System.Text.Json from the .NET Base Class Library and the write uses System.IO.File.WriteAllText, both built-in APIs.

Why does profiler-save-data return an error when writing the file?▼

The tool returns an [Error] result when filePath is empty or the file write fails, and the message includes the underlying exception text. Check that the path is valid and the process has write permissions.

Can profiler-save-data create missing output directories?▼

Yes, the tool automatically creates any missing parent directories for the specified filePath before writing the JSON snapshot, so nested output paths work without manual setup.