perf-design

Profile codebases to generate prioritized performance designs with benchmark scaffolds.

7|4|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/nklisch/skills --skill perf-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-design
Source: https://github.com/nklisch/skills/tree/main/plugins/workflow/skills/perf-design
Command: npx skills add https://github.com/nklisch/skills --skill perf-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Profilers and performance engineers often struggle to translate profiling results into concrete, implementable improvements. Perf-design provides a structured approach to identify bottlenecks and produce an actionable design with benchmarks.

Core Features & Use Cases

  • Profile-driven bottleneck detection across languages and runtimes.
  • Hierarchy-guided optimization plan (Algorithmic, I/O, Language idioms, Parallelism) with implementation-unit design artifacts.
  • Generates a benchmark scaffold and an implementation document suitable for downstream tooling.
  • Supports spawning a profiling sub-agent to gather language-specific guidance.

Quick Start

Run perf-design on the target project to generate a ready-to-implement performance design with benchmark scaffolds.

Frequently Asked Questions about perf-design

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

FAQPage Schema
How do I translate profiling results into an actionable optimization plan?

To translate profiling results into an actionable optimization plan, use a profile-driven approach that identifies bottlenecks and generates a hierarchical plan covering algorithmic, I/O, language idioms, and parallelism optimizations.

What is the best way to design performance improvements for a multi-language codebase?

Performance design for a multi-language codebase requires a structured optimization plan that generates implementation-unit design artifacts with concrete file paths, signatures, and benchmark scaffolds for downstream tooling.

How do I generate benchmark scaffolds for code optimizations?

You generate benchmark scaffolds by running an end-to-end performance design workflow that produces an implementation-ready document including prioritized optimization tasks and the necessary benchmarking setup.

Does perf-design support profiling across different runtimes and languages?

Yes, profile-driven bottleneck detection supports multi-language projects and various runtimes, and it can spawn a profiling sub-agent to gather language-specific guidance for your optimization design.

Can I get a design document with specific file paths and signatures for performance tasks?

Yes, the performance design process outputs an implementation-unit design document including concrete file paths and signatures, task orchestration, and a prioritized plan for immediate development.

When do I need a hierarchical optimization plan for my codebase?

You need a hierarchical optimization plan when profiling reveals complex bottlenecks requiring structured improvements across algorithmic complexity, I/O operations, language idioms, and parallelism strategies.