Skip to main content
Agent skills are instruction sets that teach AI coding assistants how to perform specific tasks with CodSpeed. They work alongside the MCP server — the MCP server provides access to your performance data, while skills provide the know-how to act on it.
Skills require the CodSpeed MCP server to be configured. Set up the MCP server first if you have not already.

Installation

/plugin marketplace add CodSpeedHQ/codspeed
/plugin install codspeed
The plugin installs both the MCP server and agent skills automatically.

Alternative: auto-detect with npx skills

If your agent supports it, you can use npx skills to automatically detect installed agents and configure them:
npx skills add CodSpeedHQ/codspeed

Available skills

Optimize (codspeed-optimize)

Turns your AI assistant into an autonomous performance engineer. It works in a loop and keeps iterating until there is nothing left to gain.
  1. Measure — run the benchmarks to establish a baseline.
  2. Analyze — query flamegraphs to identify hot spots and bottlenecks.
  3. Optimize — make a targeted change to the source code.
  4. Re-measure and compare — run benchmarks again and compare against the baseline. Repeat until no further gains.
Example prompts:
“Make my parse_input function faster.”
“Find the bottleneck in bench_serialize and fix it.”
“Optimize the hot path in this module.”
“There’s a regression on feat/parser — investigate.”

Setup Harness (codspeed-setup-harness)

Analyzes your project, picks the right benchmarking framework for your language, writes representative benchmarks, and verifies the setup works through the CodSpeed CLI. Supports Rust, Python, Node.js, Go, C/C++, and any language via the exec harness. The Optimize skill relies on benchmarks to measure performance. If your project does not have benchmarks yet, the Setup Harness skill will be triggered automatically to create them. Example prompts:
“Add benchmarks to this project.”
“Set up CodSpeed for my Rust project.”
“Benchmark this function.”