Agent skill

Perfup

by raullenchai in raullenchai/Rapid-MLX

Autonomous performance optimization: research, PoC, benchmark, implement, review, PR

Custom licenceAuto-check: notesAI & LLM Engineering

Install Perfup

skills CLI
$ npx skills add raullenchai/Rapid-MLX --skill perfup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install raullenchai/Rapid-MLX perfup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/raullenchai/Rapid-MLX.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/perfup .claude/skills/perfup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
perfup
GitHub stars
3.9k
Token cost
~1.6k tokens
SKILL.md length
635 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
Custom licence

At a glance

Autonomous performance optimization: research, PoC, benchmark, implement, review, PR

  • Works in 6 steps: Research → Prioritize → PoC Experiment Loop → …
  • Tasks that involve LLM inference and serving
  • SKILL.md covers Key Files, The 6 Phases, Results TSV Format and Focus Areas, plus 1 more section
  • Calls gh and git

What it does

Perfup is an agent skill from raullenchai/Rapid-MLX. Autonomous performance optimization: research, PoC, benchmark, implement, review, PR

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering LLM inference and serving, Performance optimization and Pull requests. It works with Anthropic API, Model Context Protocol, Ollama and OpenAI. The repository describes itself as: Rapid-MLX is an open-source (Apache 2.0) OpenAI- and Anthropic-compatible LLM inference server for Apple Silicon, built on MLX, focused on reliable tool calling for coding…

When your agent uses it

  • Tasks that involve LLM inference and serving
  • Tasks that involve Performance optimization
  • Tasks that involve Pull requests

Example prompts

  • “/perfup”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob, Grep, Task, WebSearch, WebFetch, Skill, TaskCreate, TaskUpdate, TaskList, TaskGet, EnterPlanMode, ExitPlanMode, AskUserQuestion

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Research
  2. Prioritize
  3. PoC Experiment Loop
  4. Full Implementation
  5. Review Loop
  6. PR & Ship

What it can do on your machine

Read from SKILL.md and the folder at commit bf3f199. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Glob
    • Grep
    • Task
    • WebSearch
    • WebFetch
    • Skill

    …and 7 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Perfup loads about 1.6k tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 635 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Glob, Grep, Task, WebSearch, WebFetch, Skill, TaskCreate, TaskUpdate, TaskL

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 635 words (~1,644 tokens).

“Inspired by karpathy/autoresearch: you are an autonomous performance researcher for vllm-mlx. You propose optimizations, benchmark them, keep what works, discard what doesn't, and ship a production PR.”

— opening of SKILL.md by raullenchai, Custom licence
name
perfup
allowed-tools
Bash, Read, Write, Edit, Glob, Grep, Task, WebSearch, WebFetch, Skill, TaskCreate, TaskUpdate, TaskList, TaskGet, EnterPlanMode, ExitPlanMode, AskUserQuestion
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/perfup of raullenchai/Rapid-MLX.

Open the folder on GitHubat commit bf3f199

Compare with similar skills

Perfup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Perfup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Perfup this skillraullenchai/Rapid-MLX3.9k—~1.6kAutomated safety check: NotesCustom licence
Agent Frameworkjihadkhawaja/Egroo178—~1.9kAutomated safety check: PassApache-2.0
Mesh APImr-tbot/mesh-api180—~1.8kAutomated safety check: PassGPL-3.0
Facturasgustavoeenriquez/MakerAi212—~127Automated safety check: PassMIT
VllmPrism-Shadow/penguin-harness2.5k—~1kAutomated safety check: PassApache-2.0
Tanstack AIsecondsky/claude-skills227—~3.6kAutomated safety check: NotesMIT

Similar skills

  • Agent Framework

    jihadkhawaja/Egroo

    Build, extend, and debug AI agents in Egroo using the Microsoft Agent Framework (C .NET).

    178 GitHub stars~1.9k tokensUpdated 6 mo ago
    AI & LLM EngineeringAuto-check passed
  • Mesh API

    mr-tbot/mesh-api

    Interact with a Meshtastic LoRa mesh network through MESH-API — list nodes, read messages, send texts, and check connection status.

    180 GitHub stars~1.8k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Facturas

    gustavoeenriquez/MakerAi

    Úsalo cuando el usuario pida redactar una factura, una cuenta de cobro o una nota de cobro.

    212 GitHub stars~127 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Vllm

    Prism-Shadow/penguin-harness

    Deploy and serve LLMs with vLLM behind an OpenAI-compatible endpoint, with tool calling enabled for agent workloads.

    2.5k GitHub stars~1k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Tanstack AI

    secondsky/claude-skills

    TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama.

    227 GitHub stars~3.6k tokensUpdated 11 days ago
    AI & LLM EngineeringAuto-check: notes
  • Forkmind

    ccplugins/awesome-claude-code-plugins

    A skill your agent uses when debugging, comparing, or regression-testing LLM / agent calls — when the user wants to capture LLM traffic, see a conversation as a branchable DAG, fork an alternative…

    970 GitHub stars~868 tokensUpdated 1 mo ago
    Testing & QAAuto-check passed

Questions about Perfup

What does Perfup do?

Autonomous performance optimization: research, PoC, benchmark, implement, review, PR. Perfup is an agent skill from raullenchai/Rapid-MLX.

When should I use Perfup?

Perfup fits situations like: tasks that involve LLM inference and serving; tasks that involve Performance optimization; tasks that involve Pull requests.

How do I install Perfup in Claude Code?

Run `npx skills add raullenchai/Rapid-MLX --skill perfup -a claude-code`. Or copy the skill folder (.claude/skills/perfup in raullenchai/Rapid-MLX) into .claude/skills/perfup in your project. Claude Code loads it when a task matches its description.

How do I install Perfup in Codex?

Run `npx skills add raullenchai/Rapid-MLX --skill perfup -a codex`. Or copy the skill folder (.claude/skills/perfup in raullenchai/Rapid-MLX) into .agents/skills/perfup in your project. Codex loads it when a task matches its description.

Can I use Perfup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add raullenchai/Rapid-MLX --skill perfup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/perfup, .gemini/skills/perfup, .github/skills/perfup and .opencode/skills/perfup in your project.

What does Perfup need to run?

Going by SKILL.md and its folder, Perfup needs the command-line tools its instructions call (gh and git). Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob, Grep, Task, WebSearch, WebFetch, Skill, TaskCreate, TaskUpdate, TaskList, TaskGet, EnterPlanMode, ExitPlanMode, AskUserQuestion.

Does Perfup access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Perfup safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Perfup use?

Perfup has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Perfup use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Perfup?

Skills that share tags, products or a category with Perfup: Agent Framework (jihadkhawaja/Egroo, 178 stars), Mesh API (mr-tbot/mesh-api, 180 stars), Facturas (gustavoeenriquez/MakerAi, 212 stars) and Vllm (Prism-Shadow/penguin-harness, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Perfup?

raullenchai (a GitHub user) maintains it in raullenchai/Rapid-MLX, which has 3,945 GitHub stars. The repository was last updated on October 9, 2026.

Source: raullenchai/Rapid-MLX on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.