bundles/session/skills/workspace-performance-audit/SKILL.md
Orchestrates comprehensive performance audits across full-stack monorepos. Coordinates performance-expert, design-consistency-auditor, accessibility, security-expert, and qa-reviewer skills to audit frontend, backend, database, browser extensions, and shared packages. Use when asked for a full workspace performance review, monorepo audit, or to identify bottlenecks across frontend, backend, and extensions.
npx skillsauth add shipshitdev/library workspace-performance-auditInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Inputs:
Outputs:
Creates/Modifies:
.agents/memory/performance-audit-YYYY-MM-DD.md — writes the audit reportExternal Side Effects:
Confirmation Required:
Delegates To:
performance-expert for metrics and optimizationdesign-consistency-auditor for UI/UX consistencyqa-reviewer for validation and prioritization| Skill | Focus Area | Phase |
|-------|------------|-------|
| performance-expert | Performance metrics & optimization | 1-4 |
| design-consistency-auditor | UI/UX consistency & design debt | 1 |
| accessibility | WCAG 2.1 AA compliance | 1 |
| security-expert | Security validation | 2 |
| qa-reviewer | Validation & prioritization | 5 |
Phase 0: Workspace Discovery
→ Identify apps, packages, tech stacks
Phase 1: Frontend Audit (Next.js)
→ Core Web Vitals, Bundle Analysis, Design, A11y
Phase 2: Backend Audit (NestJS)
→ API Response Times, N+1 Queries, Security
Phase 3: Database Audit (MongoDB)
→ Query Performance, Index Analysis
Phase 4: Extension & Packages
→ Bundle Sizes, Memory, Dependencies
Phase 5: Consolidation
→ Aggregate, Score, Prioritize, Report
| Domain | Key Metrics | Targets | |--------|-------------|---------| | Frontend | LCP, FID, CLS | <2.5s, <100ms, <0.1 | | Backend | p50, p95 response | <100ms, <200ms | | Database | Query p95, Index hit | <50ms, >95% | | Extension | Content script size | <50KB |
Quick Audit: Essential checks only → 1-page summary Full Audit: All phases → Complete report Domain-Specific: Single domain focus
For detailed phase execution, metric collection commands, report templates, and example interactions: load ${CLAUDE_SKILL_DIR}/references/full-guide.md when starting a full audit or when a specific phase requires detailed guidance.
development
Coordinates a weekly engineering review of board accuracy, recent code changes, operational health, and scoped cleanup. Use for a recurring repository health review or a review of the last several days.
testing
Audits project board configuration and prepares explicitly requested setup, copy, or normalization changes while preserving the existing workflow and provider boundaries. Use when inspecting a board's fields, columns, scope, or configuration.
testing
Reconciles a project board with current work and delivery evidence, reports incomplete coverage and metadata gaps, and applies only approved provider-supported field changes. Use when auditing board drift, reviewing blocked work, or assessing upcoming delivery.
development
Walk through how a subsystem works. Use for "how does X work", code walkthroughs before changing something, and placement or ownership questions. Explains architecture, runtime flow, and onboarding mental models. Can critique architecture. Use why for motivation.