[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76J2Y05ZX2WAJQQN3DAK7VB":3,"skill-same:01M76J2Y05ZX2WAJQQN3DAK7VB":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":32,"ownerHtmlUrl":33,"ownerBlogUrl":34,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M76J2Y05ZX2WAJQQN3DAK7VB","nestjs-features-performance",null,"Selects and implements NestJS runtime features, error and API contracts, security, testing, DevOps, performance, and safe scale. Use for middleware, guards, pipes, interceptors, exception filters, typed failures\u002Fresults, Problem Details, validation errors, HTTP\u002FGraphQL\u002FRPC\u002FgRPC\u002FWebSocket error mapping, deadlines, cancellation, retry classification, fatal process errors, authentication, authorization, caching, queues, schedulers, CI\u002FCD, containers, Kubernetes, configuration and secrets, migrations, supply-chain controls, health probes, logs\u002Fmetrics\u002Ftraces, SLOs and alerts, incident recovery, rollout and rollback, event-loop or database bottlenecks, load tests, horizontal scaling, idempotency, backpressure, and graceful shutdown. Do not use for frontend-only performance or non-NestJS services. When other skills also apply, reconcile ownership before mutation.","bg-szy\u002FTOP-SKILLS","bg-szy","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F106576190?v=4","01M73A4E8KPV67SFXRY8XZGNBX","ShuZhiyong","01M73A4E96MQ294MHM74TZBVQD",6,"MIT","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Fnestjs-features-performance\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: nestjs-features-performance\ndescription: 'Selects and implements NestJS runtime features, error and API contracts, security, testing, DevOps, performance, and safe scale. Use for middleware, guards, pipes, interceptors, exception filters, typed failures\u002Fresults, Problem Details, validation errors, HTTP\u002FGraphQL\u002FRPC\u002FgRPC\u002FWebSocket error mapping, deadlines, cancellation, retry classification, fatal process errors, authentication, authorization, caching, queues, schedulers, CI\u002FCD, containers, Kubernetes, configuration and secrets, migrations, supply-chain controls, health probes, logs\u002Fmetrics\u002Ftraces, SLOs and alerts, incident recovery, rollout and rollback, event-loop or database bottlenecks, load tests, horizontal scaling, idempotency, backpressure, and graceful shutdown. Do not use for frontend-only performance or non-NestJS services. When other skills also apply, reconcile ownership before mutation.'\nlicense: MIT\nmetadata:\n  author: amirtaherkhani\n  version: '1.3.2'\n---\n\n# NestJS Features, Scaling, and Performance\n\nChoose the NestJS primitive whose lifecycle matches the concern. Diagnose the limiting resource before optimizing or distributing the system.\n\n## Pre-execution conflict guard\n\nBefore editing files or running any state-changing command, reconcile active instructions. Read-only inspection may continue.\n\n### Prerequisites\n\nInspect repository instructions, installed versions, bootstrap\u002Ftransport and deployment configuration, tests, operational contracts, and baseline measurements. Preserve user changes; establish lifecycle, evidence, environment, and authorization before choosing an optimization or delivery action. Read other active skills only when their decisions overlap.\n\n### Primary ownership\n\nThis skill owns Nest lifecycle, API\u002Ferror\u002Fsecurity contracts, test layers, performance evidence, reliability, observability, and runtime delivery. When installed and relevant, coordinate with:\n\n- `nestjs-architecture-principles`: module, dependency, data, and transaction boundaries.\n- `nestjs-oop-design-patterns`: object responsibilities, invariants, and patterns.\n- `nestjs-professional-software-engineering`: implementation and verification.\n- `nestjs-code-audit`: read-only quality evidence and deduplicated reporting.\n- `nestjs-feature-audit`: branch-specific roadmap gate and feature reporting.\n- `nestjs-git-commit-pr-message`: authorized Git publication and CI follow-up.\n\nThese are decision boundaries, not required dependencies. Retain domain ownership when handing work to another workflow.\n\n### Conflict test\n\nCheck for incompatible edits\u002Fcontracts, command order or side effects, competing owners, and unmet version, evidence, authorization, or repository prerequisites. Resolve using explicit user intent, repository contracts, verified runtime constraints, then the narrowest owner. Assign one lead per decision; do not create parallel designs to satisfy incompatible advice. If a material conflict remains, stop before mutation and ask for the smallest missing decision. Audits stay read-only; explicit fix authorization applies in a distinct implementation phase.\n\n## Establish the runtime baseline\n\nBefore recommending or changing behavior:\n\n1. Read the installed NestJS\u002FNode versions, bootstrap code, adapter, modules, transports, persistence clients, cache\u002Fqueue setup, and deployment manifests.\n2. Trace one representative request, message, or job through guards, pipes, interceptors, handlers, providers, persistence, and external calls.\n3. Identify the current symptom and evidence: latency percentiles, throughput, error rate, event-loop delay, CPU, heap\u002FGC, database time, pool saturation, external latency, or queue lag.\n4. Define a target and workload. \"Make it faster\" is not a measurable acceptance criterion.\n5. Check framework and library APIs against official documentation and the repository version.\n\nNever claim a performance improvement from code appearance. Measure before and after under a representative workload.\n\n## Put behavior in the correct NestJS feature\n\nUse [references\u002Ffeature-selection.md](references\u002Ffeature-selection.md).\n\nGeneral HTTP lifecycle:\n\n```text\nrequest\n  -> middleware\n  -> guards\n  -> interceptors (before)\n  -> pipes\n  -> controller\u002Fresolver + providers\n  -> interceptors (after, reverse order)\n  -> exception filters for uncaught errors\n  -> response\n```\n\nDefaults:\n\n- **Middleware:** raw protocol preprocessing and correlation context.\n- **Guard:** authentication\u002Fauthorization decision for an execution context.\n- **Pipe:** input validation and transformation.\n- **Interceptor:** behavior around handler execution, response mapping, timing, tracing, or compatible caching.\n- **Exception filter:** final protocol-specific error mapping.\n- **Decorator:** declarative metadata or extraction of established context, not hidden I\u002FO.\n- **Provider\u002Fapplication operation:** business behavior and orchestration.\n- **Queue\u002Fworker:** durable, deferred, bursty, or resource-heavy work.\n- **Event:** a completed fact with independent reactions; choose in-process versus durable delivery explicitly.\n\nFor API and transport guidance, load [references\u002Fapi-runtime.md](references\u002Fapi-runtime.md). Use the focused rulebooks for [error handling](references\u002Ferror-handling.md), [security](references\u002Fsecurity.md), [testing](references\u002Ftesting.md), [API design](references\u002Fapi-design.md), and [deployment](references\u002Fdevops-deployment.md) when those risks are in scope.\n\n## Diagnose performance by resource\n\nUse [references\u002Fperformance-diagnosis.md](references\u002Fperformance-diagnosis.md).\n\nClassify the primary constraint before selecting a remedy:\n\n| Constraint | Evidence | Typical first moves |\n| --- | --- | --- |\n| Event-loop blocking | High event-loop delay\u002Futilization, CPU callback hotspots | Remove synchronous work; bound input; offload CPU work |\n| Database | Slow queries, N+1, pool waits, locks, high rows scanned | Fix query shape\u002Findexes; bound results; shorten transactions |\n| External I\u002FO | Dependency spans dominate latency | Deadlines, connection reuse, bounded retry, concurrency control |\n| Memory\u002FGC | Heap growth, GC pauses, OOM\u002Frestarts | Remove retention; stream\u002Fbound data; profile allocations |\n| Serialization\u002Flogging | CPU or payload size grows with response | Select fields; paginate\u002Fstream; reduce hot-path logging |\n| Capacity | Stable per-instance performance but saturated replicas | Horizontal scale with stateless processes and safe dependencies |\n\nDo not switch to Fastify, add Redis, introduce worker threads, or split services before evidence identifies the bottleneck and compatibility cost is understood.\n\n## Scaling rules\n\nUse [references\u002Fscaling-reliability.md](references\u002Fscaling-reliability.md).\n\n1. Keep web replicas stateless; move shared sessions, locks, job state, and coordination to appropriate external systems.\n2. Prefer default singleton providers. Request scope propagates through the injection chain and adds per-request allocation; use only for a real lifetime requirement.\n3. Bound every collection, page, batch, queue concurrency, retry count, payload, upload, and timeout.\n4. Make jobs and message consumers idempotent. Assume duplicate delivery and partial failure.\n5. Use exponential backoff with jitter for transient failures; never blindly retry validation, authorization, or invariant errors.\n6. Add backpressure. Reject, shed, pause, or queue load instead of allowing unbounded memory and latency growth.\n7. Separate user-facing processes from CPU-heavy or slow background work when their capacity profiles differ.\n8. Treat caches as derived state. Define key namespace, TTL, invalidation, stampede behavior, and safe fallback.\n9. Drain before shutdown: stop accepting work, mark unready, finish or safely requeue in-flight work, then close resources.\n10. Scale from service-level objectives and saturation signals, not average CPU alone.\n\n## Implementation workflow\n\n### Add or change a feature\n\n1. Locate the correct lifecycle stage and existing repository convention.\n2. Define the contract, scope, and failure behavior.\n3. Implement the smallest provider\u002Fcomponent and bind it at the narrowest useful level.\n4. Test its behavior in isolation and its ordering\u002Fwiring at a boundary.\n5. Update OpenAPI\u002Fschema, configuration validation, telemetry, and docs when the public or operational contract changes.\n\n### Design or repair error handling\n\n1. Inventory every entry point, current public error contract, filter binding, adapter\u002Fvendor error, client dependency, and partial side effect.\n2. Classify expected business, validation, identity\u002Faccess, conflict, transient, permanent, cancellation\u002Ftimeout, and unknown failures without parsing messages.\n3. Define the application-owned type\u002Fresult and translate vendor failures at infrastructure adapters while preserving a safe cause.\n4. Map each HTTP, GraphQL, RPC\u002FgRPC, WebSocket, or worker boundary independently; keep one non-sensitive unknown fallback.\n5. Define deadlines, cancellation, retry\u002Fidempotency, acknowledgement, transaction, and unknown-outcome behavior before adding recovery logic.\n6. Bind the narrowest correct NestJS filter\u002Fhandler and verify hybrid, gateway, adapter, stream, and process-fatal paths as applicable.\n7. Test the stable contract, side effects, observability ownership, sensitive-data absence, and restart\u002Frecovery behavior.\n\n### Optimize a slow path\n\n1. Reproduce with a controlled benchmark or trace.\n2. Record baseline percentiles, throughput, errors, and resource saturation.\n3. Profile the dominant path.\n4. Change one limiting factor.\n5. Repeat the same workload and compare.\n6. Run correctness and failure tests; faster incorrect behavior is a regression.\n7. Document the capacity limit and rollback signal.\n\n### Plan scale\n\n1. Define workload shape, SLO, consistency, durability, and cost constraints.\n2. Estimate per-instance capacity and identify shared dependency limits.\n3. Choose vertical tuning, replicas, workers, queues, partitions, or service extraction based on the actual resource boundary.\n4. Design overload and partial-failure behavior before adding capacity.\n5. Prove the plan with load, soak, spike, and failure tests appropriate to the risk.\n\n### Build, deploy, or diagnose production\n\n1. Identify the source revision, immutable artifact\u002Fimage digest, target environment, and owner.\n2. Compare repository intent, built artifact, desired deployment, and running state; do not infer live state from configuration files alone.\n3. Define migration\u002Fconfiguration compatibility, rollout strategy, success signals, abort threshold, and rollback or forward-repair path.\n4. Apply the smallest authorized change through the repository's delivery mechanism.\n5. Verify live revision, readiness, representative traffic\u002Fwork, errors, latency, saturation, queues\u002Fdependencies, and drain behavior.\n6. Record the release or incident evidence and reconcile any emergency drift back into declared state.\n\n## Production gate\n\nUse [references\u002Fproduction-readiness.md](references\u002Fproduction-readiness.md) before calling a feature production-ready. At minimum verify configuration, security, contracts, resource bounds, observability, health\u002Freadiness, shutdown, and recovery.\n\n## Reference routing\n\n| Task | Load |\n| --- | --- |\n| Pick middleware, guard, pipe, interceptor, filter, decorator, event, queue, or scheduler | [feature-selection.md](references\u002Ffeature-selection.md) |\n| Build HTTP\u002FGraphQL\u002FWebSocket\u002FSSE\u002Fmicroservice contracts and tests | [api-runtime.md](references\u002Fapi-runtime.md) |\n| Classify failures, map stable errors, or design filters and retries | [error-handling.md](references\u002Ferror-handling.md) |\n| Define typed errors\u002Fresults, public codes, validation shape, Problem Details, or HTTP semantics | [error-taxonomy-contracts.md](references\u002Ferror-taxonomy-contracts.md) |\n| Implement filters across HTTP, GraphQL, RPC\u002FgRPC, WebSocket, workers, or hybrid apps | [exception-filters-transports.md](references\u002Fexception-filters-transports.md) |\n| Design deadlines, cancellation, safe retries, fatal-process handling, telemetry, or failure tests | [failure-resilience-testing.md](references\u002Ffailure-resilience-testing.md) |\n| Review authentication, authorization, validation, secrets, output, or abuse controls | [security.md](references\u002Fsecurity.md) |\n| Choose unit, module, integration, contract, E2E, or reliability tests | [testing.md](references\u002Ftesting.md) |\n| Design DTOs, responses, errors, pagination, idempotency, or versioning | [api-design.md](references\u002Fapi-design.md) |\n| Diagnose latency, CPU, event loop, database, memory, cache, or Fastify choices | [performance-diagnosis.md](references\u002Fperformance-diagnosis.md) |\n| Add replicas, workers, queues, retries, idempotency, backpressure, or distributed coordination | [scaling-reliability.md](references\u002Fscaling-reliability.md) |\n| Design build, configuration, migration, health, observability, rollout, or shutdown controls | [devops-deployment.md](references\u002Fdevops-deployment.md) |\n| Build CI\u002FCD, container images, provenance, promotion, or artifact rollback | [ci-cd-containers.md](references\u002Fci-cd-containers.md) |\n| Configure or diagnose Kubernetes workloads, probes, resources, HPA, rollout, or termination | [kubernetes-operations.md](references\u002Fkubernetes-operations.md) |\n| Define SLOs, logs\u002Fmetrics\u002Ftraces, alerts, dashboards, incidents, backups, or recovery | [observability-sre.md](references\u002Fobservability-sre.md) |\n| Review operational readiness and rollout safety | [production-readiness.md](references\u002Fproduction-readiness.md) |\n\n## Expected response\n\nFor performance\u002Fscaling work, report:\n\n- **Symptom and target**\n- **Baseline evidence**\n- **Primary constraint**\n- **Recommended change and trade-off**\n- **Correctness\u002Ffailure risks**\n- **Before\u002Fafter verification plan**\n\nIf evidence is missing, propose the smallest measurement needed before an architectural change.\n\nFor Error Handling work, report:\n\n- **Failure model:** categories, stable codes\u002Ftypes, and expected versus unknown behavior.\n- **Boundary mapping:** application-to-transport mapping for every affected entry point.\n- **Effects and resilience:** committed\u002Fpossible side effects, deadline, cancellation, retry\u002Fidempotency, and recovery ownership.\n- **Disclosure:** public fields, redaction, logging ownership, and sensitive-data controls.\n- **Framework wiring:** filter\u002Fhandler scope, execution context, adapter\u002Fhybrid coverage, and fatal-process behavior.\n- **Verification:** contract, adapter, timeout, duplicate, partial-effect, privacy, and restart tests.\n\nFor DevOps work, report:\n\n- **Release identity:** source revision, artifact\u002Fdigest, environment, and owner.\n- **State comparison:** repository intent, desired deployment, and observed runtime.\n- **Safety:** migrations\u002Fconfiguration compatibility, security gates, and failure risks.\n- **Rollout:** strategy, success\u002Fabort signals, observation window, and capacity impact.\n- **Verification:** live revision, health, representative work, telemetry, and drain.\n- **Recovery:** rollback or forward-repair procedure and trigger.\n","# NestJS Features, Scaling, and Performance\n\nChoose the NestJS primitive whose lifecycle matches the concern. Diagnose the limiting resource before optimizing or distributing the system.\n\n## Pre-execution conflict guard\n\nBefore editing files or running any state-changing command, reconcile active instructions. Read-only inspection may continue.\n\n### Prerequisites\n\nInspect repository instructions, installed versions, bootstrap\u002Ftransport and deployment configuration, tests, operational contracts, and baseline measurements. Preserve user changes; establish lifecycle, evidence, environment, and authorization before choosing an optimization or delivery action. Read other active skills only when their decisions overlap.\n\n### Primary ownership\n\nThis skill owns Nest lifecycle, API\u002Ferror\u002Fsecurity contracts, test layers, performance evidence, reliability, observability, and runtime delivery. When installed and relevant, coordinate with:\n\n- `nestjs-architecture-principles`: module, dependency, data, and transaction boundaries.\n- `nestjs-oop-design-patterns`: object responsibilities, invariants, and patterns.\n- `nestjs-professional-software-engineering`: implementation and verification.\n- `nestjs-code-audit`: read-only quality evidence and deduplicated reporting.\n- `nestjs-feature-audit`: branch-specific roadmap gate and feature reporting.\n- `nestjs-git-commit-pr-message`: authorized Git publication and CI follow-up.\n\nThese are decision boundaries, not required dependencies. Retain domain ownership when handing work to another workflow.\n\n### Conflict test\n\nCheck for incompatible edits\u002Fcontracts, command order or side effects, competing owners, and unmet version, evidence, authorization, or repository prerequisites. Resolve using explicit user intent, repository contracts, verified runtime constraints, then the narrowest owner. Assign one lead per decision; do not create parallel designs to satisfy incompatible advice. If a material conflict remains, stop before mutation and ask for the smallest missing decision. Audits stay read-only; explicit fix authorization applies in a distinct implementation phase.\n\n## Establish the runtime baseline\n\nBefore recommending or changing behavior:\n\n1. Read the installed NestJS\u002FNode versions, bootstrap code, adapter, modules, transports, persistence clients, cache\u002Fqueue setup, and deployment manifests.\n2. Trace one representative request, message, or job through guards, pipes, interceptors, handlers, providers, persistence, and external calls.\n3. Identify the current symptom and evidence: latency percentiles, throughput, error rate, event-loop delay, CPU, heap\u002FGC, database time, pool saturation, external latency, or queue lag.\n4. Define a target and workload. \"Make it faster\" is not a measurable acceptance criterion.\n5. Check framework and library APIs against official documentation and the repository version.\n\nNever claim a performance improvement from code appearance. Measure before and after under a representative workload.\n\n## Put behavior in the correct NestJS feature\n\nUse [references\u002Ffeature-selection.md](references\u002Ffeature-selection.md).\n\nGeneral HTTP lifecycle:\n\n```text\nrequest\n  -> middleware\n  -> guards\n  -> interceptors (before)\n  -> pipes\n  -> controller\u002Fresolver + providers\n  -> interceptors (after, reverse order)\n  -> exception filters for uncaught errors\n  -> response\n```\n\nDefaults:\n\n- **Middleware:** raw protocol preprocessing and correlation context.\n- **Guard:** authentication\u002Fauthorization decision for an execution context.\n- **Pipe:** input validation and transformation.\n- **Interceptor:** behavior around handler execution, response mapping, timing, tracing, or compatible caching.\n- **Exception filter:** final protocol-specific error mapping.\n- **Decorator:** declarative metadata or extraction of established context, not hidden I\u002FO.\n- **Provider\u002Fapplication operation:** business behavior and orchestration.\n- **Queue\u002Fworker:** durable, deferred, bursty, or resource-heavy work.\n- **Event:** a completed fact with independent reactions; choose in-process versus durable delivery explicitly.\n\nFor API and transport guidance, load [references\u002Fapi-runtime.md](references\u002Fapi-runtime.md). Use the focused rulebooks for [error handling](references\u002Ferror-handling.md), [security](references\u002Fsecurity.md), [testing](references\u002Ftesting.md), [API design](references\u002Fapi-design.md), and [deployment](references\u002Fdevops-deployment.md) when those risks are in scope.\n\n## Diagnose performance by resource\n\nUse [references\u002Fperformance-diagnosis.md](references\u002Fperformance-diagnosis.md).\n\nClassify the primary constraint before selecting a remedy:\n\n| Constraint | Evidence | Typical first moves |\n| --- | --- | --- |\n| Event-loop blocking | High event-loop delay\u002Futilization, CPU callback hotspots | Remove synchronous work; bound input; offload CPU work |\n| Database | Slow queries, N+1, pool waits, locks, high rows scanned | Fix query shape\u002Findexes; bound results; shorten transactions |\n| External I\u002FO | Dependency spans dominate latency | Deadlines, connection reuse, bounded retry, concurrency control |\n| Memory\u002FGC | Heap growth, GC pauses, OOM\u002Frestarts | Remove retention; stream\u002Fbound data; profile allocations |\n| Serialization\u002Flogging | CPU or payload size grows with response | Select fields; paginate\u002Fstream; reduce hot-path logging |\n| Capacity | Stable per-instance performance but saturated replicas | Horizontal scale with stateless processes and safe dependencies |\n\nDo not switch to Fastify, add Redis, introduce worker threads, or split services before evidence identifies the bottleneck and compatibility cost is understood.\n\n## Scaling rules\n\nUse [references\u002Fscaling-reliability.md](references\u002Fscaling-reliability.md).\n\n1. Keep web replicas stateless; move shared sessions, locks, job state, and coordination to appropriate external systems.\n2. Prefer default singleton providers. Request scope propagates through the injection chain and adds per-request allocation; use only for a real lifetime requirement.\n3. Bound every collection, page, batch, queue concurrency, retry count, payload, upload, and timeout.\n4. Make jobs and message consumers idempotent. Assume duplicate delivery and partial failure.\n5. Use exponential backoff with jitter for transient failures; never blindly retry validation, authorization, or invariant errors.\n6. Add backpressure. Reject, shed, pause, or queue load instead of allowing unbounded memory and latency growth.\n7. Separate user-facing processes from CPU-heavy or slow background work when their capacity profiles differ.\n8. Treat caches as derived state. Define key namespace, TTL, invalidation, stampede behavior, and safe fallback.\n9. Drain before shutdown: stop accepting work, mark unready, finish or safely requeue in-flight work, then close resources.\n10. Scale from service-level objectives and saturation signals, not average CPU alone.\n\n## Implementation workflow\n\n### Add or change a feature\n\n1. Locate the correct lifecycle stage and existing repository convention.\n2. Define the contract, scope, and failure behavior.\n3. Implement the smallest provider\u002Fcomponent and bind it at the narrowest useful level.\n4. Test its behavior in isolation and its ordering\u002Fwiring at a boundary.\n5. Update OpenAPI\u002Fschema, configuration validation, telemetry, and docs when the public or operational contract changes.\n\n### Design or repair error handling\n\n1. Inventory every entry point, current public error contract, filter binding, adapter\u002Fvendor error, client dependency, and partial side effect.\n2. Classify expected business, validation, identity\u002Faccess, conflict, transient, permanent, cancellation\u002Ftimeout, and unknown failures without parsing messages.\n3. Define the application-owned type\u002Fresult and translate vendor failures at infrastructure adapters while preserving a safe cause.\n4. Map each HTTP, GraphQL, RPC\u002FgRPC, WebSocket, or worker boundary independently; keep one non-sensitive unknown fallback.\n5. Define deadlines, cancellation, retry\u002Fidempotency, acknowledgement, transaction, and unknown-outcome behavior before adding recovery logic.\n6. Bind the narrowest correct NestJS filter\u002Fhandler and verify hybrid, gateway, adapter, stream, and process-fatal paths as applicable.\n7. Test the stable contract, side effects, observability ownership, sensitive-data absence, and restart\u002Frecovery behavior.\n\n### Optimize a slow path\n\n1. Reproduce with a controlled benchmark or trace.\n2. Record baseline percentiles, throughput, errors, and resource saturation.\n3. Profile the dominant path.\n4. Change one limiting factor.\n5. Repeat the same workload and compare.\n6. Run correctness and failure tests; faster incorrect behavior is a regression.\n7. Document the capacity limit and rollback signal.\n\n### Plan scale\n\n1. Define workload shape, SLO, consistency, durability, and cost constraints.\n2. Estimate per-instance capacity and identify shared dependency limits.\n3. Choose vertical tuning, replicas, workers, queues, partitions, or service extraction based on the actual resource boundary.\n4. Design overload and partial-failure behavior before adding capacity.\n5. Prove the plan with load, soak, spike, and failure tests appropriate to the risk.\n\n### Build, deploy, or diagnose production\n\n1. Identify the source revision, immutable artifact\u002Fimage digest, target environment, and owner.\n2. Compare repository intent, built artifact, desired deployment, and running state; do not infer live state from configuration files alone.\n3. Define migration\u002Fconfiguration compatibility, rollout strategy, success signals, abort threshold, and rollback or forward-repair path.\n4. Apply the smallest authorized change through the repository's delivery mechanism.\n5. Verify live revision, readiness, representative traffic\u002Fwork, errors, latency, saturation, queues\u002Fdependencies, and drain behavior.\n6. Record the release or incident evidence and reconcile any emergency drift back into declared state.\n\n## Production gate\n\nUse [references\u002Fproduction-readiness.md](references\u002Fproduction-readiness.md) before calling a feature production-ready. At minimum verify configuration, security, contracts, resource bounds, observability, health\u002Freadiness, shutdown, and recovery.\n\n## Reference routing\n\n| Task | Load |\n| --- | --- |\n| Pick middleware, guard, pipe, interceptor, filter, decorator, event, queue, or scheduler | [feature-selection.md](references\u002Ffeature-selection.md) |\n| Build HTTP\u002FGraphQL\u002FWebSocket\u002FSSE\u002Fmicroservice contracts and tests | [api-runtime.md](references\u002Fapi-runtime.md) |\n| Classify failures, map stable errors, or design filters and retries | [error-handling.md](references\u002Ferror-handling.md) |\n| Define typed errors\u002Fresults, public codes, validation shape, Problem Details, or HTTP semantics | [error-taxonomy-contracts.md](references\u002Ferror-taxonomy-contracts.md) |\n| Implement filters across HTTP, GraphQL, RPC\u002FgRPC, WebSocket, workers, or hybrid apps | [exception-filters-transports.md](references\u002Fexception-filters-transports.md) |\n| Design deadlines, cancellation, safe retries, fatal-process handling, telemetry, or failure tests | [failure-resilience-testing.md](references\u002Ffailure-resilience-testing.md) |\n| Review authentication, authorization, validation, secrets, output, or abuse controls | [security.md](references\u002Fsecurity.md) |\n| Choose unit, module, integration, contract, E2E, or reliability tests | [testing.md](references\u002Ftesting.md) |\n| Design DTOs, responses, errors, pagination, idempotency, or versioning | [api-design.md](references\u002Fapi-design.md) |\n| Diagnose latency, CPU, event loop, database, memory, cache, or Fastify choices | [performance-diagnosis.md](references\u002Fperformance-diagnosis.md) |\n| Add replicas, workers, queues, retries, idempotency, backpressure, or distributed coordination | [scaling-reliability.md](references\u002Fscaling-reliability.md) |\n| Design build, configuration, migration, health, observability, rollout, or shutdown controls | [devops-deployment.md](references\u002Fdevops-deployment.md) |\n| Build CI\u002FCD, container images, provenance, promotion, or artifact rollback | [ci-cd-containers.md](references\u002Fci-cd-containers.md) |\n| Configure or diagnose Kubernetes workloads, probes, resources, HPA, rollout, or termination | [kubernetes-operations.md](references\u002Fkubernetes-operations.md) |\n| Define SLOs, logs\u002Fmetrics\u002Ftraces, alerts, dashboards, incidents, backups, or recovery | [observability-sre.md](references\u002Fobservability-sre.md) |\n| Review operational readiness and rollout safety | [production-readiness.md](references\u002Fproduction-readiness.md) |\n\n## Expected response\n\nFor performance\u002Fscaling work, report:\n\n- **Symptom and target**\n- **Baseline evidence**\n- **Primary constraint**\n- **Recommended change and trade-off**\n- **Correctness\u002Ffailure risks**\n- **Before\u002Fafter verification plan**\n\nIf evidence is missing, propose the smallest measurement needed before an architectural change.\n\nFor Error Handling work, report:\n\n- **Failure model:** categories, stable codes\u002Ftypes, and expected versus unknown behavior.\n- **Boundary mapping:** application-to-transport mapping for every affected entry point.\n- **Effects and resilience:** committed\u002Fpossible side effects, deadline, cancellation, retry\u002Fidempotency, and recovery ownership.\n- **Disclosure:** public fields, redaction, logging ownership, and sensitive-data controls.\n- **Framework wiring:** filter\u002Fhandler scope, execution context, adapter\u002Fhybrid coverage, and fatal-process behavior.\n- **Verification:** contract, adapter, timeout, duplicate, partial-effect, privacy, and restart tests.\n\nFor DevOps work, report:\n\n- **Release identity:** source revision, artifact\u002Fdigest, environment, and owner.\n- **State comparison:** repository intent, desired deployment, and observed runtime.\n- **Safety:** migrations\u002Fconfiguration compatibility, security gates, and failure risks.\n- **Rollout:** strategy, success\u002Fabort signals, observation window, and capacity impact.\n- **Verification:** live revision, health, representative work, telemetry, and drain.\n- **Recovery:** rollback or forward-repair procedure and trigger.\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"version":26},"amirtaherkhani","1.3.2","master","fd76f882a04e445e899d5cfb2732f2105ea054ee","skills\u002Fmarketplace\u002Fnestjs-features-performance",0,"https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS","https:\u002F\u002Fbg-szy.github.io\u002FTOP-SKILLS\u002F","https:\u002F\u002Fgithub.com\u002Fbg-szy","https:\u002F\u002Fwww.ecust.edu.cn\u002F","a student of East China University of Science and Technology","2026-11-15 03:38:02",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add bg-szy\u002FTOP-SKILLS --skill nestjs-features-performance",{"tool":43,"command":44},"bunx","bunx skills add bg-szy\u002FTOP-SKILLS --skill nestjs-features-performance",{"tool":46,"command":47},"pnpm","pnpm dlx skills add bg-szy\u002FTOP-SKILLS --skill nestjs-features-performance","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Fnestjs-features-performance\u002FSKILL.md",true,[51],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"skill-report.json","REFERENCE","参考文档",54723,"https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Fnestjs-features-performance\u002Fskill-report.json",[58,66,73,80,87,94],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":65},"01M7DXW9N826PKXK174PVW3038","serpmaven","Scrape Google search results (SERP) to JSON with SERP Maven (serpmaven) - a real Chrome browser on a residential proxy with sticky sessions. Run it as a CLI, a Python library, a local HTTP search API (`serve`), an MCP server or a Docker image; set the proxy login, workers, pages and cost tracking. Use when the user wants Google results, rank tracking, a self-hosted SERP API, or live Google search for an AI agent.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Fserpmaven\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":65},"01M7DXVHSTWDV65475QEQ915M7","revnu-landing-page-audit","Find out why a landing page isn't turning visitors into signups, demos or sales. Audits one page against what the ad, post or search that sends people there promised, then checks the first screen, proof, call to action, friction and mobile. Returns at most 7 prioritized fixes, plus what is fine and what could not be checked; rewrites specific lines and fixes the page in the repo when asked. Never promises a conversion lift. Works without a Revnu account. Use when the user says or asks: \"audit my landing page\", \"why isn't this page converting\", \"review my homepage\", \"my ads get clicks but no signups\", \"people bounce from the pricing page\", \"CRO review\", \"improve conversion rate\", \"is my hero section clear\", \"roast my landing page\", \"rewrite my headline\", \"what's wrong with this page\", \"landing page feedback\", \"make the signup page convert better\". Not for SEO or AI-search audits, page speed engineering on its own, or building a new page from scratch.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-landing-page-audit\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":65},"01M7DXV8X2D7B3VTD4HHYYHTGR","revnu-growth-context","Write down once who buys, what they're stuck on, what it costs, what proof you have and what you've already tried, so every growth task starts from facts instead of a questionnaire. Creates or updates .agents\u002Frevnu-growth.md from the repo, the live site and the user, and imports an existing product-marketing.md. Use when the user says \"set up our marketing context\", \"who is our ideal customer\", \"write our ICP\", \"describe the product for marketing\", \"positioning doc\", \"what's our brand voice\", \"remember this about our customers\", \"log what we tried\", \"what have we learned from marketing\", \"we changed pricing, update the context\", \"update our growth notes\", \"summarize the business for the agent\", \"import my product-marketing.md\", \"start a growth doc\", or before a first marketing, SEO, outreach or launch task when no context file exists. Works without a Revnu account.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-growth-context\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":65},"01M7DXV0DGJ1G0A60PAHC6J3C5","revnu-get-listed","Get onto the third-party pages AI answers and search cite when buyers ask for the best tool in your category: \"best X\" roundups, directories, review sites, GitHub awesome lists, community threads and comparison pages. Finds which ones are cited, ranks them by fit and effort, and drafts each submission, PR or pitch by the target's own rules. Use when the user says \"get us listed\", \"which directories should we submit to\", \"how do we get into best-of lists\", \"why does ChatGPT recommend competitors and not us\", \"get mentioned in AI answers\", \"submit to awesome lists\", \"get on G2\", \"where are our competitors listed\", \"pitch listicle authors\", \"find backlink opportunities\", \"launch directories\", \"get into roundups\", \"Product Hunt alternatives\", \"where should we be listed\", \"get cited by Perplexity\". Never submits, pays or posts without a yes. Works without a Revnu account.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-get-listed\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":65},"01M7DXTSPMGT9D6DSS0HP9BSTA","revnu-ai-readiness-audit","Audit whether your website gives ChatGPT, Perplexity, Claude, Gemini and Google's AI Overviews something worth quoting, and fix the pages that don't. Use when the user says or asks \"is my site ready for AI search\", \"audit my site for AI answers\", \"AEO audit\", \"GEO audit\", \"why doesn't ChatGPT quote our pricing\", \"make our pages citable by AI\", \"do I need llms.txt\", \"does schema help with ChatGPT\", \"check our structured data\", \"is our content visible without JavaScript\", \"AI SEO audit\", \"optimize our homepage for AI answers\", \"LLM SEO check\", \"why does AI get our product wrong\", \"fix our site for AI Overviews\". Checks fetchability and indexability, answers in the raw HTML, entity facts, schema (including JS-injected markup), headings, dates and llms.txt, then gives at most 10 prioritised fixes and edits the repo when asked. Works without a Revnu account.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Frevnu-ai-readiness-audit\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":65},"01M7DXSZHCVTRS620GC3S97JZV","proxy-troubleshooting","Diagnose residential proxy failures, with NodeMaven's gateway as the reference - 407 with correct credentials, 406, 410, 500, a connection that hangs, ERR_TUNNEL_CONNECTION_FAILED in a browser, Playwright or Puppeteer ignoring proxy credentials, a sticky session that changes IP, geo-targeting that is silently ignored, passwords with special characters, and unexpected traffic from headless Chrome. Use when a proxy connection fails, returns the wrong location, or costs more traffic than expected.","https:\u002F\u002Fgithub.com\u002Fbg-szy\u002FTOP-SKILLS\u002Fblob\u002Fmaster\u002Fskills\u002Fmarketplace\u002Fproxy-troubleshooting\u002FSKILL.md",[],[]]