mcpField
W
workspace-performance-audit

workspace-performance-audit

github.com/shipshitdevTesting & quality38182 installsUpdated 2d ago
Repository

About workspace-performance-audit

workspace-performance-audit is a read-only skill for auditing performance across a monorepo. It supports quick, full, or domain-focused audits and produces prioritized recommendations for development teams.

Key features

  1. 01Monorepo and stack discovery
  2. 02Quick, full, or domain-specific audits
  3. 03Frontend, backend, database, and extension checks
  4. 04Performance metrics and target thresholds
  5. 05Prioritized recommendations with severity
  6. 06Report-only analysis without external side effects

Use cases

  1. 01Reviewing performance before a release
  2. 02Investigating slow frontend or API responses
  3. 03Checking database query and index metrics
  4. 04Auditing one selected workspace domain

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shipshitdev/skills --skill workspace-performance-audit

After installing, type/workspace-performance-auditin Claude Code to confirm it loaded.

Bundled filesplugin.jsonreferences/full-guide.md

Details

From the project README

Workspace Performance Audit

Authorized Scope

Act only within the user's request and existing approval; loading this skill grants no new authority. Keep report-only requests report-only, honor the caller's target, host, provider, and cost limits, ask before expanding scope, and forward these limits to delegates.

Contract

Inputs:

  • Monorepo root path (defaults to current working directory)
  • Optional: target domain(s) to focus on (frontend, backend, database, extension)
  • Optional: audit mode (quick or full)

Outputs:

  • Consolidated performance audit report
  • Prioritized recommendations with severity ratings

Creates/Modifies:

  • .agents/memory/performance-audit-YYYY-MM-DD.md — writes the audit report

External Side Effects:

  • None. Read-only analysis only; does not deploy, modify, or install anything.

Confirmation Required:

  • Before writing the output report if the target path is outside the current workspace

Delegates To:

  • performance-expert for metrics and optimization
  • design-consistency-auditor for UI/UX consistency
  • qa-reviewer for validation and prioritization

Skills Orchestrated

SkillFocus AreaPhase
performance-expertPerformance metrics & optimization1-4
design-consistency-auditorUI/UX consistency & design debt1
accessibilityWCAG 2.1 AA compliance1
security-expertSecurity validation2
qa-reviewerValidation & prioritization5

Orchestration Flow

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 (Postgres)
    → Query Performance, Index Analysis

Phase 4: Extension & Packages
    → Bundle Sizes, Memory, Dependencies

Phase 5: Consolidation
    → Aggregate, Score, Prioritize, Report

Key Metrics by Domain

DomainKey MetricsTargets
FrontendLCP, FID, CLS<2.5s, <100ms, <0.1
Backendp50, p95 response<100ms, <200ms
DatabaseQuery p95, Index hit<50ms, >95%
ExtensionContent script size<50KB

Usage Modes

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.

Comments

Markdown supported