Back to Skills

typescript-e2e-testing

E2E and integration testing for TypeScript/NestJS projects using Jest, supertest, and real infrastructure via Docker (Kafka, PostgreSQL, MongoDB, Redis) with the Given-When-Then pattern. Use whenever the user is working on `.e2e-spec.ts` files or anything under `test/e2e/`, or asks to set up, write, review, run, debug, or optimize E2E or integration tests — including flaky tests, docker-compose for tests, Kafka/Redpanda consumers, test isolation, or GWT compliance.

12stars2forksUpdated 6/23/2026

Security Assessment

Safe(100/100)

Detected risks:

Agent-reviewed override(Testing guidance; describes Docker/DB/infra commands as examples, no dangerous execution.)
Security Score100/100

About typescript-e2e-testing

The typescript-e2e-testing skill provides end-to-end and integration testing for TypeScript and NestJS projects using Jest and supertest against real infrastructure via Docker (Kafka, PostgreSQL, MongoDB, and Redis), following the Given-When-Then pattern. It activates for work on .e2e-spec.ts files or anything under test/e2e, and for setting up, writing, reviewing, running, debugging, or optimizing E2E and integration tests.

It is organized around six workflows (setup, writing, review, running, debugging, and optimize) selected by detecting the user's intent, each of which loads specific knowledge files. A structured references knowledge base covers shared fundamentals (core concepts, mandatory rules, best practices, GWT templates, NestJS setup, debugging) plus technology-specific folders for Kafka, PostgreSQL, MongoDB, Redis, and APIs with their rules, test helpers, Docker setups, and examples. A core principle is context efficiency: redirecting verbose E2E output to temp files with a unique session ID rather than the console, and fixing one failing test at a time.

It is most useful for engineers building or maintaining E2E and integration tests for NestJS services that depend on real infrastructure, including handling flaky tests, test isolation, and performance optimization.

FAQ

When should I use this skill?

When working on .e2e-spec.ts files or test/e2e, or asking to set up, write, review, run, debug, or optimize E2E and integration tests for TypeScript/NestJS.

What stack does it target?

TypeScript and NestJS with Jest and supertest, running against real Kafka, PostgreSQL, MongoDB, and Redis infrastructure via Docker, using the Given-When-Then pattern.

How is it organized?

Around six intent-selected workflows (setup, writing, review, running, debugging, optimize), each loading specific reference knowledge files for the relevant technology.

How does it keep output manageable?

By redirecting verbose E2E test output to temp files with a unique session ID instead of the console, to avoid bloating agent context.

Does it help with flaky tests?

Yes. It covers test isolation (for example Kafka pre-subscription patterns), debugging one failing test at a time, and performance optimization.

All Files

103 files
references/api/examples.md13.0 KB
View
references/api/test-helper.md5.5 KB
View
references/common/knowledge.md2.6 KB
View
references/kafka/docker-setup.md6.7 KB
View
references/kafka/performance.md7.6 KB
View
references/postgres/test-helper.md5.5 KB
View
LICENSE1.0 KB
View
references/api/rules.md6.3 KB
View
references/common/examples.md17.3 KB
View
references/common/test-case-creation-guide.md8.5 KB
View
references/kafka/knowledge.md10.7 KB
View
references/mongodb/docker-setup.md3.4 KB
View
references/mongodb/examples.md10.6 KB
View
references/postgres/examples.md9.7 KB
View
references/redis/examples.md10.0 KB
View
references/api/knowledge.md2.8 KB
View
references/common/best-practices.md6.9 KB
View
references/common/nestjs-setup.md7.9 KB
View
references/kafka/examples.md11.0 KB
View
references/kafka/rules.md13.0 KB
View
references/mongodb/rules.md4.5 KB
View
references/mongodb/test-helper.md4.3 KB
View
references/redis/docker-setup.md3.7 KB
View
SKILL.md14.4 KB
View
references/api/mocking.md8.8 KB
View
references/common/debugging.md9.5 KB
View
references/common/rules.md6.3 KB
View
references/kafka/isolation.md16.6 KB
View
references/kafka/test-helper.md24.3 KB
View
references/mongodb/knowledge.md2.8 KB
View
references/postgres/knowledge.md2.6 KB
View
references/postgres/rules.md5.2 KB
View
references/redis/rules.md4.5 KB
View
references/redis/knowledge.md2.6 KB
View
workflows/debugging/steps/step-04-isolate.md1.6 KB
View
workflows/debugging/steps/step-05-root-cause.md2.9 KB
View
workflows/debugging/workflow.md4.2 KB
View
workflows/optimize/steps/step-01b-continue.md1.9 KB
View
workflows/optimize/steps/step-05-setup-optimization.md2.1 KB
View
references/redis/test-helper.md4.6 KB
View
workflows/debugging/steps/step-01b-continue.md1.9 KB
View
workflows/debugging/steps/step-03-classify.md1.4 KB
View
workflows/debugging/steps/step-06-apply-fix.md2.2 KB
View
workflows/debugging/steps/step-01-init.md2.4 KB
View
workflows/debugging/steps/step-08-next-or-done.md1.9 KB
View
workflows/optimize/steps/step-03-identify-opportunities.md1.9 KB
View
workflows/optimize/steps/step-07-code-organization.md2.3 KB
View
workflows/optimize/workflow.md3.4 KB
View
workflows/running/steps/step-01b-continue.md1.8 KB
View
workflows/debugging/steps/step-02-capture-failure.md1.3 KB
View
workflows/debugging/templates/tracking-template.md0.3 KB
View
workflows/optimize/steps/step-02-baseline.md2.0 KB
View
workflows/optimize/steps/step-06-execution-optimization.md2.1 KB
View
workflows/optimize/templates/report-template.md0.3 KB
View
workflows/review/steps/step-02-test-structure.md1.9 KB
View
workflows/debugging/steps/step-07-verify-fix.md1.6 KB
View
workflows/optimize/steps/step-01-init.md2.3 KB
View
workflows/optimize/steps/step-04-infra-optimization.md1.7 KB
View
workflows/optimize/steps/step-08-verify.md1.8 KB
View
workflows/optimize/steps/step-09-document.md1.7 KB
View
workflows/review/steps/step-01b-continue.md1.7 KB
View
workflows/review/steps/step-05-test-isolation.md2.0 KB
View
workflows/review/steps/step-06-tech-patterns.md2.4 KB
View
workflows/review/steps/step-01-init.md2.8 KB
View
workflows/review/steps/step-04-assertion-quality.md2.3 KB
View
workflows/running/steps/step-02-pre-run.md1.8 KB
View
workflows/running/steps/step-06-handle-failures.md2.2 KB
View
workflows/running/workflow.md4.2 KB
View
workflows/review/steps/step-03-gwt-compliance.md2.4 KB
View
workflows/review/steps/step-07-summary.md2.4 KB
View
workflows/review/templates/report-template.md0.3 KB
View
workflows/running/steps/step-01-init.md2.0 KB
View
workflows/running/steps/step-04-execute.md1.8 KB
View
workflows/review/workflow.md2.9 KB
View
workflows/running/steps/step-03-determine-scope.md1.3 KB
View
workflows/running/steps/step-07-verify-fixes.md1.5 KB
View
workflows/setup/steps/step-01-init.md2.5 KB
View
workflows/running/steps/step-05-interpret-results.md1.8 KB
View
workflows/running/templates/output-template.md0.3 KB
View
workflows/setup/steps/step-02-project-analysis.md1.6 KB
View
workflows/setup/steps/step-06-test-helpers.md1.7 KB
View
workflows/setup/templates/output-template.md0.3 KB
View
workflows/writing/steps/step-07-error-cases.md1.9 KB
View
workflows/running/steps/step-08-cleanup.md1.4 KB
View
workflows/setup/steps/step-01b-continue.md1.9 KB
View
workflows/setup/steps/step-05-docker-compose.md1.6 KB
View
workflows/setup/steps/step-09-verification.md2.0 KB
View
workflows/writing/steps/step-01b-continue.md1.9 KB
View
workflows/writing/workflow.md3.0 KB
View
workflows/setup/steps/step-03-directory-structure.md1.3 KB
View
workflows/setup/steps/step-07-global-setup.md1.0 KB
View
workflows/setup/workflow.md3.0 KB
View
workflows/writing/steps/step-03-code-analysis.md1.6 KB
View
workflows/setup/steps/step-04-jest-config.md1.5 KB
View
workflows/setup/steps/step-08-example-test.md1.3 KB
View
workflows/writing/steps/step-01-init.md2.7 KB
View
workflows/writing/steps/step-04-test-structure.md1.9 KB
View
workflows/writing/steps/step-02-requirements.md1.7 KB
View
workflows/writing/steps/step-06-happy-path.md2.3 KB
View
workflows/writing/templates/output-template.md0.3 KB
View
workflows/writing/steps/step-05-test-setup.md1.6 KB
View
workflows/writing/steps/step-09-final-review.md1.9 KB
View
workflows/writing/steps/step-08-async-tests.md2.1 KB
View

Install typescript-e2e-testing

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill