ns-download-asset

Downloads N|Solid heap snapshots, CPU profiles, and heap profiles to local disk by asset ID.

6|7|Updated Jun 4, 2026
One-click install
npx skills add https://github.com/nodesource/nsolid-plugin --skill ns-download-asset-nodesource
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ns-download-asset
Source: https://github.com/nodesource/nsolid-plugin/tree/main/skills/ns-download-asset
Command: npx skills add https://github.com/nodesource/nsolid-plugin --skill ns-download-asset-nodesource

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? N|Solid diagnostic assets like heap snapshots and CPU profiles are large binary files that cannot be safely pulled through MCP tools or ad hoc HTTP calls without breaking sessions or corrupting data. This Skill downloads them reliably to local disk so they can be opened in external tools like Chrome DevTools or snapshot parsers. ## Core Features & Use Cases - Asset Download by ID: Fetches cpuprofile, heapprofile, or heapsnapshot assets from the N|Solid console API using a bundled script with authenticated, HTTPS-validated requests. - Deduplication and Indexing: Reuses already-downloaded files by asset ID and registers every asset in .nsolid/assets/index.json for discovery by other tooling. - Safe Handling of Large Files: Streams downloads to disk with gzip decompression, atomic writes, and a 10-minute deadline, never loading raw asset data into the AI context. - Use Case: After capturing a heap snapshot of a leaking production app, ask the assistant to download the asset locally, then open the resulting .heapsnapshot file in Chrome DevTools for manual inspection. ## Quick Start Ask the assistant to download the N|Solid heap snapshot with a given asset ID for your application so you can inspect it in Chrome DevTools.

Frequently Asked Questions about ns-download-asset

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

FAQPage Schema
How do I download an N|Solid heap snapshot to my local machine?▼

Provide the asset ID and let the skill run its bundled fetch-asset.cjs script with the asset type heapsnapshot and your app name. The file is saved under .nsolid/assets/ and registered in index.json for later discovery.

How do I export an N|Solid CPU profile for Chrome DevTools?▼

Download the asset with the cpuprofile asset type, which produces a .cpuprofile file on local disk. That file can be opened directly in Chrome DevTools or other compatible profiling tools.

Why should I not use the MCP asset tool to download N|Solid assets?▼

The MCP asset tool is deprecated because it inlines raw data into the response and kills the session with a session expired error on large assets. The bundled fetch-asset.cjs script streams the file to disk instead.

What credentials are needed to download N|Solid assets?▼

The script reads consoleUrl and serviceToken from ~/.agents/.nodesource-auth.json, created by authenticating with your NodeSource account. The console URL must use HTTPS and cannot resolve to a private or local address.

Does downloading the same N|Solid asset twice create duplicate files?▼

No. The script deduplicates by asset ID and reuses the existing file if it was already downloaded, migrating legacy layouts to the flat naming scheme when needed.

Can this skill analyze the downloaded heap snapshot contents?▼

No. This skill only downloads and registers the raw file; analysis is handled by the ns-analyze-asset skill via asset-summary. Raw asset contents are never read into the AI context.