detecting-performance-warnings

Detect optimization barriers in Truffle DSL compilation with source locations.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/antonykamp/cc-truffle-performance-plugin --skill detecting-performance-warnings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: detecting-performance-warnings
Source: https://github.com/antonykamp/cc-truffle-performance-plugin/tree/main/skills/detecting-performance-warnings
Command: npx skills add https://github.com/antonykamp/cc-truffle-performance-plugin --skill detecting-performance-warnings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects optimization barriers during Truffle compilation. Essential for finding virtual calls, non-constant stores, and unresolved type checks that hinder peak performance. It also highlights TruffleBoundary issues that can dampen hot-path efficiency.

Core Features & Use Cases

  • Identify optimization barriers in Truffle DSL compilations
  • Diagnose virtual calls that prevent inlining and specialization
  • Trace and report exact source locations with stack traces for faster fixes

Quick Start

Run your Truffle benchmark with the performance-warnings trace enabled to quickly locate optimization barriers.

Frequently Asked Questions about detecting-performance-warnings

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

FAQPage Schema
How do I find optimization barriers during Truffle compilation?

To find optimization barriers during Truffle compilation, you analyze Truffle DSL code to identify virtual calls, non-constant stores, and unresolved type checks. This pinpoints hotspots and inlining boundary issues across hot paths to help achieve peak performance.

Why does my Truffle DSL code fail to inline and reach peak performance?

Your Truffle DSL code fails to inline and reach peak performance due to optimization barriers like virtual calls, unresolved type checks, and TruffleBoundary issues. These barriers dampen hot-path efficiency and prevent proper specialization during compilation.

How do I trace the exact source locations of Truffle optimization warnings?

To trace the exact source locations of Truffle optimization warnings, run your Truffle benchmark with the performance-warnings trace enabled. This reports exact source locations with stack traces for faster fixes during performance investigations.

Can I use this diagnostic approach for non-DSL Truffle nodes?

No, this diagnostic approach cannot be used for non-DSL Truffle nodes. The analysis works exclusively with traditional Truffle DSL nodes to identify compilation barriers and does not support other node architectures.

What is a TruffleBoundary issue and how does it affect hot paths?

A TruffleBoundary issue is an optimization barrier that dampens hot-path efficiency during Truffle compilation. It hinders peak performance by preventing optimal inlining and specialization across critical execution paths.