venhdev/zenforge22 installs
inspect-perf
Audit source code for semantic performance debt, N+1 queries, memory retention, and concurrency bottlenecks.
How do I install this agent skill?
npx skills add https://github.com/venhdev/zenforge --skill inspect-perfIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a performance and resource efficiency auditor that analyzes source code for algorithmic risks, memory leaks, and concurrency bottlenecks. It enforces strict scope gates to ensure targeted analysis. A low-risk surface for indirect prompt injection is present as the skill processes external source code.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
inspect-perf — Semantic Performance & Resource Efficiency Auditor
Domain Rubric
1. Scope & Tolerability Guardrails (What to Ignore)
- Mandatory Target Scope: The user MUST specify an explicit target path (
file,directory, orsubsystem). If no target scope is provided, halt turn immediately and prompt for scope; forbid speculative full-repository scans. - Semantic Debt vs. Micro-Benchmarking: Confine analysis strictly to structural algorithmic risks, I/O multipliers, and resource retention; ignore sub-microsecond instruction micro-optimizations, compiler inlining nits, or premature caching on cold paths.
- Governing Reference: Evaluate performance patterns strictly against
references/performance-rubric.md.
2. Decision Bifurcation: [LOCAL-FIX] vs. [ARCHITECTURAL-REFACTOR]
[LOCAL-FIX](Localized In-Function Optimization): Algorithmic lookup indexing ($O(1)$ set/map), loop invariant hoisting, or string builder replacement within a single method/file. Route behavior-preserving candidates to/simplify-audit; new query limits or altered result semantics require/changeset.[ARCHITECTURAL-REFACTOR](Systemic Structural Remediation): Decomposing Cartesian joins into Split Queries / DataLoaders, extracting Transactional Outbox to decouple network I/O from database transactions, worker thread offloading, or introducing bounded distributed caches. Route remediation to/changeset.
Canonical Output Contract
# Performance Audit Dossier: <Target Scope>
## 1. Executive Summary
- **Target Inspected**: `<directory_or_file_path>`
- **Health Rating**: <OPTIMAL | LOCALIZED_BOTTLENECK | CRITICAL_DEGRADATION>
- **Primary Bottleneck**: <Single-sentence summary of highest-latency or highest-risk resource hazard>
## 2. Load-Bearing Defect Catalog
### [<CRITICAL | MAJOR>] [<LOCAL-FIX | ARCHITECTURAL-REFACTOR>] <Dimension>: `<Target Symbol / Query>`
- **Offending Code**: [<file>#L<N>](file:///path/to/file#L<N>)
- **Violated Rubric**: [<spec_or_dimension>](references/performance-rubric.md#anchor)
- **Smell**: <Observable bottleneck, complexity multiplier, or resource leak description>
- **Action**: <[LOCAL-FIX] Local optimization OR [ARCHITECTURAL-REFACTOR] Separation / batching path>
*(Emit 'No load-bearing performance defects observed across rubric dimensions' if clean)*
Routing
- Local indexing or builder changes whose behavior equivalence can be audited → (via /simplify-audit).
- Changes to result semantics or systemic split-query, outbox, connection-pool, or thread-pool refactorings → (via /changeset).
Execution Protocol
-
Intake & Scope Gate:
- Ingest target scope (
file,directory, orsubsystem). - Enforce Scope Gate: If no explicit scope is provided, halt turn immediately and prompt user:
"Please specify an explicit target scope (file, directory, or subsystem) when invoking /inspect-perf." - Read and ground in
references/performance-rubric.md.
- Ingest target scope (
-
Scale-Adaptive Pragmatic Audit:
- In-Turn Execution (< 10 files or cohesive module): Audit code directly in-turn against rubric dimensions.
- Subagent Fan-Out (broad multi-package subsystem): Launch concurrent
researchsubagents dynamically scaled to partitioned slices or caller-declared budget (Role:Performance Inspector (<Slice>)) seeded with slice coordinates, discovered anchors, Domain Rubric, and Output Contract (offload extensive profiling traces to.agents/scratch/perf-<slice>-dossier.md). - Enforce Section 1 Guardrails: ignore micro-benchmarking noise on non-hot paths; classify every finding explicitly as
[LOCAL-FIX]or[ARCHITECTURAL-REFACTOR].
-
Synthesis & Turn-Halt Gate:
- Consolidate findings into the Canonical Output Contract with pointers to any offloaded dossiers.
- Assign definitive Health Rating (
OPTIMAL,LOCALIZED_BOTTLENECK,CRITICAL_DEGRADATION). - Present completed dossier into conversation stream and halt turn immediately.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/venhdev/zenforge/inspect-perf">View inspect-perf on skillZs</a>