system-profile

Profile Python scripts, processes, GPU workloads, and interconnect topologies into structured reports.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/jandan138/Auto-claude-code-research-in-sleep --skill system-profile-jandan138
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-profile
Source: https://github.com/jandan138/Auto-claude-code-research-in-sleep/tree/main/skills/system-profile
Command: npx skills add https://github.com/jandan138/Auto-claude-code-research-in-sleep --skill system-profile-jandan138

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Profile the specified target and summarize performance metrics across CPU, memory, GPU, and interconnect, producing structured reports with actionable recommendations.

Core Features & Use Cases

  • Multi-target profiling: profile Python scripts, running processes, GPU workloads, memory usage, and interconnect topology.
  • Instrumentation guidance: write minimal instrumentation to measure hotspots and bottlenecks without perturbing performance.
  • Structured reports: generate tables and charts (CPU overhead, memory footprint, interconnect bandwidth) and actionable recommendations.
  • Quick-start oriented: supports end-to-end workflows from target selection to artifact saving in ./profile_output/.

Quick Start

Tell me the target you want profiled (e.g., 'train.py', 'gpu', or 'PID 1234') and I will run profiling and return a structured report.

Frequently Asked Questions about system-profile

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

FAQPage Schema
How do I profile a Python script to generate CPU and memory performance metrics?

To profile a Python script, you specify the target file like 'train.py' and the system runs profiling to generate structured performance metrics across CPU and memory. It produces actionable recommendations and saves artifacts to a dedicated profile_output directory.

Can I profile a running process by PID to identify memory bottlenecks?

Yes, you can profile a running process by providing its PID. The system attaches to the target process to measure memory usage and CPU hotspots, generating structured reports with actionable recommendations without requiring application restarts.

What is the best way to profile GPU workloads and interconnect bandwidth?

The best way to profile GPU workloads and interconnect bandwidth is to specify 'gpu' as your target. The system analyzes the GPU workload and interconnect topology, producing structured tables and charts that highlight bandwidth bottlenecks.

Do I need to write instrumentation code to measure performance hotspots?

You need minimal instrumentation to measure hotspots and bottlenecks accurately. The system provides specific instrumentation guidelines designed to capture performance metrics without significantly perturbing the application's runtime behavior.

Does performance profiling work in both development and production environments?

Performance profiling works effectively in development, testing, and production environments. The system supports profiling Python scripts, running processes, and GPU workloads across these distinct contexts to identify bottlenecks.

What format are the profiling reports saved in?

Profiling reports are saved as structured artifacts containing tables and charts in a dedicated profile_output directory. These reports include CPU overhead metrics, memory footprints, and actionable recommendations for performance optimization.