Skip to content
cccskills
FreePublished on GitHub

loopx-performance-diagnosis

Investigate observed slowdowns or increased CPU, memory allocation, and IO costs in a process you control. Use controlled timing and runtime-specific profiling tools to test a cause, then check performance and behavior after a fix.

OriginalShow the original description

Diagnose demonstrated CPU, command latency, allocation or IO regressions in an owned process with controlled measurements and language-appropriate profilers. Route benchmark effectiveness, score growth and trajectory efficiency to loopx-benchmark; profiling does not qualify a budget or grant execution authority.

See how to install

Good for

  • Investigate a command that has become slower
  • Locate CPU or memory allocation hotspots
  • Separate transport waits from backend processing costs
  • Verify performance and behavior after a fix

Files included (3)

  • SKILL.md4.0 KB
  • .loopx-skill-scope7 B
  • agents/openai.yaml317 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

LoopX performance diagnosis

First identify the question. For a LoopX-managed benchmark's outcome quality, score growth, useful progress per time/token, or agent trajectory, use loopx-benchmark. A flatter score curve, repeated reads or more tokens alone do not establish a process-performance regression. Keep that analysis with the benchmark owner; use this skill as a focused subtask only when evidence identifies a slow owned command or resource cost. Do not require a profiler before analyzing effectiveness or interaction overhead.

Read the current Goal/Todo contract and repository optimization evidence rules. State the real user operation, observed failure and owning acceptance. Preserve the exact source, runtime/interpreter, backend/history, inputs and concurrency. Use an owned disposable target for writes. Do not attach to a production process, elevate privileges, weaken OS policy, or start paid/remote workloads without the existing authorization. Raw stacks, paths, arguments and profiles stay ignored and local-private; public summaries contain only generalized evidence.

Read loopx/capabilities/performance_diagnosis/README.md for tool selection and blind spots. On installed copies use loopx capability show performance-diagnosis to locate its canonical documentation. Python waits/startup: Pyinstrument; Python threads/native on Linux: py-spy; allocations: Memray; Node/TS: V8 CPU/heap. Go/JVM/kernel costs need their native tools. Research official sources when the installed runtime or missing evidence makes the documented choice uncertain. Do not choose a tool from popularity or claim one profiler covers every layer.

  1. Run the uninstrumented target and record ordinary elapsed time. Use repeated controlled samples for comparisons; profiling time is not a baseline or p95.
  2. Verify the optional tool version locally. Preserve the selected interpreter; install optional tools in an isolated environment when authorized. Do not silently install them into product dependencies or fall back on permissions.
  3. Write the exact target argv to an ignored JSON array. Run loopx performance-diagnosis plan --tool TOOL --command-json FILE --output-directory FRESH_IGNORED_DIRECTORY --format json. Read the whole plan. A plan has not executed or verified tool readiness.
  4. Execute profile_argv through the Host executor as an argv array without shell interpolation. Capture only the owned process; record failures and coverage gaps. Profile a separate Node worker instead of inferring its CPU from Python transport waits. Do not collect locals or automatically profile unrelated children.
  5. Require actual successful target exit and nonempty artifact. Read Speedscope or V8 CPU using loopx performance-diagnosis inspect --profile-json FILE --format json; Memray/heap use their own reporters. Keep threads independent and self/inclusive time distinct. Never sum inclusive rows to obtain latency.
  6. Turn the hotspot into a falsifiable hypothesis. Use a controlled intervention to distinguish caller/transport, shared semantics and backend cost. Reuse the owning contract; do not skip freshness, authority checks or decision inputs.
  7. Repeat the original uninstrumented workload and semantic checks after a fix. Preserve passed, failed and untested results and update the existing checkpoint. Readback of a stack does not prove root cause, improvement or provider admission.

Do not add a new receipt/approval requirement or automatically mutate scheduling, Goal state or telemetry. Stop invoking the workflow to disable it; remove optional tools/captures from their owned local environment when no longer needed.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Guide role-specific work in LoopX auto-research, from defining research conditions and proposing hypotheses to experiments, evaluation, and adoption or retirement decisions. Keep evidence, failed attempts, task handoffs, and stopping conditions tied to each worker’s assigned role.

  • Define research objectives, metrics, and editable scope
  • Record hypotheses and unsuccessful research directions
  • Run a selected experiment and capture evidence
loopx-project/loopx6.4KUpdated Oct 19, 2026

loopx-benchmark

FreeSummary

Guides LoopX benchmark experiments through benchmark-toolkit, covering run management, comparisons under matched conditions, and analysis of agent action histories. It helps explain outcomes and efficiency while tracking source versions, score validity, and evidence boundaries.

  • Planning and managing benchmark runs
  • Comparing baselines and treatments under matched conditions
  • Diagnosing outcomes and efficiency from agent action histories
loopx-project/loopx6.4KUpdated Oct 19, 2026

Review the exact final set of changes for a LoopX goal, checking reuse, simplification, concrete risks, and project validations. Record and verify a quality receipt, a review record tied to those specific changes.

  • Reviewing final changes before delivery or merge
  • Checking reuse and opportunities to simplify code
  • Recording validation results and concrete quality risks
loopx-project/loopx6.4KUpdated Oct 19, 2026

Register lasting project documents in a connected LoopX project's document registry, using metadata that conceals private details. This helps future agents locate relevant designs, research notes, procedures, and other project materials.

  • Registering design documents and wiki references
  • Keeping research notes and papers discoverable
  • Recording procedures and migration reports
loopx-project/loopx6.4KUpdated Oct 19, 2026

loopx-manager

FreeSummary

Reviews authorized LoopX goals, tasks, and deliveries to explain project progress and identify decisions the owner needs to make. It also guides handoffs to suitable agents while preserving the original objective, constraints, and evidence.

  • Summarizing progress across active projects
  • Identifying decisions that need the owner's input
  • Handing work to a suitable agent
loopx-project/loopx6.4KUpdated Oct 19, 2026

loopx-material

FreeSummary

Manage a project's stored materials through inventory, migration, archiving, and ranking based on verified source reads. Changes follow owner approval, preserve material references, and include validation records and rollback procedures.

  • Inventory stored materials before migration
  • Rank reading candidates using verified sources
  • Archive materials while preserving references
loopx-project/loopx6.4KUpdated Oct 19, 2026

See all skills by loopx-project

Report a problem with this skill