skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills94 installs

unity-test

Run Unity Test Runner operations asynchronously

How do I install this agent skill?

npx skills add https://github.com/besty0728/unity-skills --skill unity-test
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The unity-test skill provides tools for managing and executing tests within the Unity Editor. It presents a low-risk surface for indirect prompt injection because it creates and executes code based on user-provided input parameters.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

Unity Test Skills

Run and manage Unity Test Runner tests. Parameters come from the schema (GET /skills/schema?names=<skill>&wire=v2); execution and dryRun rules: root SKILL.md.

When to use

  • Running EditMode or PlayMode tests
  • Discovering or listing tests
  • Polling asynchronous test results
  • Scaffolding test files

Rules

  • Test runs are asynchronous. test_run, test_run_by_name, test_discover_start and the test_create_* skills return a jobId at once. Poll with test_get_result(jobId) or test_discover_get_result(jobId).
  • Unity Test Runner runs one job at a time. Do not start a second test_run while another test job is active.
  • test_run in PlayMode and test_run_by_name in PlayMode enter Play Mode (MayEnterPlayMode).
  • test_create_editmode and test_create_playmode write a .cs file and trigger a domain reload. The server is briefly unavailable; retry as the root protocol describes.
  • test_list and test_list_categories return pendingDiscovery=true with a discoveryJobId on a cache miss. Poll test_discover_get_result(jobId), then call again.
  • For compile errors use debug_check_compilation in the debug module. To edit a generated test, use the script module.
  • test_smoke_skills uses transient probes, so it does not pollute workflow or batch persistence. It skips any skill with MayTriggerReload.

Pitfalls

  • test_run_all, test_create_template, test_get_status and test_run_async do not exist. Use test_run or test_run_by_name, test_create_editmode or test_create_playmode, and test_get_result.
  • test_discover_get_result and test_list both report counts, but count means different things. In test_list, count is the number returned and total is the number discovered. In test_discover_get_result, count is the number discovered and returned is the number in tests. The default limit (100) caps a larger suite: check truncated, and take the suite size from total (test_list) or count (discover).
  • test_cancel is best effort: Unity Test Runner has no hard cancel.

Skills

test_run

Run tests asynchronously. Returns a jobId at once.

ParameterTypeRequiredDefaultDescription
testModestringNo"EditMode"EditMode or PlayMode
filterstringNo-Test filter passed to the runner

Returns: {success, status, jobId, kind, testMode, filter, message}

test_run_by_name

Run specific tests by class or method name.

ParameterTypeRequiredDefaultDescription
testNamestringYes-Test class or method name
testModestringNo"EditMode"EditMode or PlayMode

Returns: {success, jobId, testName, testMode}

test_get_result

Get the result of a test run.

ParameterTypeRequiredDescription
jobIdstringYesJob ID from test_run or test_run_by_name

Returns: {success, jobId, status, totalTests, passedTests, failedTests, skippedTests, inconclusiveTests, otherTests, failedTestNames, failedTestDetails, elapsedSeconds, resultSummary, error}. Each entry in failedTestDetails has name, resultState, message, stackTrace, durationSeconds and output.

test_get_last_result

Get the most recent test run result.

Parameters: none.

Returns: {jobId, status, total, passed, failed, skipped, inconclusive, other, failedNames}

test_cancel

Cancel a running test job, best effort.

ParameterTypeRequiredDescription
jobIdstringYesJob ID to cancel

Returns: {success, jobId, status, cancelled, note, warnings}

test_list

List tests through asynchronous discovery.

ParameterTypeRequiredDefaultDescription
testModestringNo"EditMode"EditMode or PlayMode
limitintNo100Max tests to return

Returns: {success, testMode, discoveryMode, count, total, truncated, tests, pendingDiscovery, discoveryJobId, discoveryStatus}. count is the number returned; total is the number discovered.

test_list_categories

List test categories through asynchronous discovery. Same cache-miss pattern as test_list.

ParameterTypeRequiredDefaultDescription
testModestringNo"EditMode"EditMode or PlayMode

Returns: {success, testMode, discoveryMode, count, categories, pendingDiscovery, discoveryJobId, discoveryStatus, note}

test_discover_start

Start asynchronous discovery and return a discovery jobId. Use it when you want explicit control; otherwise test_list and test_list_categories start discovery on a cache miss.

ParameterTypeRequiredDefaultDescription
testModestringNo"EditMode"EditMode or PlayMode

Returns: {success, status, jobId, kind, testMode, message}

test_discover_get_result

Get the result of a discovery job.

ParameterTypeRequiredDefaultDescription
jobIdstringYes-Discovery job ID
limitintNo100Max tests in the response

Returns: {success, jobId, status, testMode, discoveryMode, count, returned, truncated, tests, error}. count is the discovered total; returned is the number in tests.

test_get_summary

Get the aggregated summary across all runs.

Parameters: none.

Returns: {success, totalRuns, completedRuns, totalPassed, totalFailed, totalSkipped, totalInconclusive, totalOther, allFailedTests}

test_smoke_skills

Run a reusable smoke test across the registered skills.

ParameterTypeRequiredDefaultDescription
categorystringNo-One SkillCategory name. An unknown name is rejected rather than tested as "all".
nameContainsstringNo-Filter skills by partial name
excludeNamesCsvstringNo-Comma-separated skill names to exclude
executeReadOnlyboolNotrueExecute safe read-only skills directly
includeMutatingboolNotrueInclude mutating skills through dryRun smoke testing
limitintNo0Max skills to inspect; 0 means all
runAsyncboolNotrueRun as a job
chunkSizeintNo25Skills per chunk
failureItemLimitintNo50Max failure entries reported

Returns: {success, totalSkills, executedCount, dryRunCount, failureCount, results}

test_create_editmode

Create an EditMode test script template.

ParameterTypeRequiredDefaultDescription
testNamestringYes-Test class name
folderstringNo"Assets/Tests/Editor"Folder for the script

Returns: {success, status, path, testName, jobId, serverAvailability}. The jobId tracks the compile.

test_create_playmode

Create a PlayMode test script template. Same behavior as test_create_editmode.

ParameterTypeRequiredDefaultDescription
testNamestringYes-Test class name
folderstringNo"Assets/Tests/Runtime"Folder for the script

Returns: {success, status, path, testName, jobId, serverAvailability}

Example

Run the EditMode suite and poll with the job ID:

curl -s "http://localhost:<port>/skill/test_run?expectProject=<project>" -d '{"testMode":"EditMode"}'
curl -s --retry 20 --retry-all-errors --retry-delay 2 "http://localhost:<port>/jobs/<jobId>?wait=60"

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-test">View unity-test on skillZs</a>