Performance Audit

A manual, evidence-based Agent Skill for auditing codebases for concrete performance risks across frontend, backend, database, network, build, caching, rendering, and runtime behavior.

The skill is intentionally review-oriented: it guides agents to inspect source manually, coordinate parallel exploration, verify every candidate finding, and report prioritized issues with file and line evidence.

Install

npx skills add plannotator/performance-audit

List available skills first:

npx skills add plannotator/performance-audit --list

Install globally:

npx skills add plannotator/performance-audit -g -y

Install from a local checkout:

npx skills add ./performance-audit -y

npx skills add is the documented install command. The CLI also accepts install as an alias for add.

As a Claude Code plugin

/plugin marketplace add plannotator/performance-audit
/plugin install performance-audit@performance-audit

Local checkout:

/plugin marketplace add <absolute-path-to-this-repo>
/plugin install performance-audit@performance-audit

As a Codex plugin

codex plugin marketplace add plannotator/performance-audit
codex plugin add performance-audit@performance-audit

Skill

• performance-audit - perform comprehensive manual codebase performance audits and produce prioritized, evidence-backed findings.

Repository Shape

skills/performance-audit/SKILL.md
skills/performance-audit/agents/openai.yaml
skills/performance-audit/references/manual-flags.md
skills.sh.json
.claude-plugin/plugin.json
.claude-plugin/marketplace.json
.codex-plugin/plugin.json
.agents/plugins/marketplace.json

Validation

Validate this publishable skill repo:

python3 /Users/ramos/.agents/skills/scaffold-skill/scripts/validate_skill_repo.py . \
  --targets vercel,claude,codex \
  --strict-frontmatter

Smoke-test local Vercel discovery:

npx skills add . --list