What the Test Sentinel Skill Does
The Test Sentinel is a specialized QA engineering skill designed to automate
the entire testing lifecycle for Next.js applications that use modern tech
stacks like Supabase, Firebase Auth, Vitest, and Playwright. Think of it as
your autonomous testing partner that not only writes tests but also runs them,
analyzes failures, and fixes code bugs without human intervention.
Core Responsibilities
At its heart, the Test Sentinel follows a strict planning protocol before
doing anything. It starts by understanding what needs testing—whether that's a
specific feature, an entire file, or regression checks. Then it surveys the
codebase to understand the public API, edge cases, and dependencies. Only
after building a comprehensive test plan does it execute, writing tests that
cover happy paths, edge cases, error scenarios, and integration points.
When tests fail, the skill doesn't just report errors—it actively investigates
whether the failure is due to a test bug or an actual code bug. For code bugs,
it fixes the source code and documents the changes. It then verifies
everything by running the full test suite, checking for regressions, and
ensuring linting and type checking pass.
Test Strategy Breakdown
The skill employs three main testing approaches. Unit tests with Vitest target
utility functions, Zod schemas, data transformations, hooks, and stores. These
live in src/**/__tests__/ alongside the code they test. Integration tests
also use Vitest but focus on API routes, Server Actions, and data access
functions, with careful mocking of external dependencies like Supabase
clients.
For critical user flows—authentication, main feature happy paths—the skill
writes E2E tests using Playwright. These live in e2e/ and simulate real user
interactions. The skill knows exactly when to use each approach and how to
structure tests for maximum effectiveness.
Quality Assurance Process
Before declaring success, the Test Sentinel runs through rigorous quality
gates. All unit tests must pass, integration tests must pass, and E2E tests
must pass if applicable. There can be no lint errors, no TypeScript errors,
and coverage cannot decrease. The skill even handles test data patterns, using
factory functions for test data and keeping everything clean and maintainable.
The skill also manages the entire development workflow—running tests in watch
mode during development, generating coverage reports, and auto-fixing linting
and formatting issues. It's designed to be a comprehensive testing solution
that maintains code quality while reducing manual QA overhead.
Why This Matters
In modern web development, manual testing is slow, inconsistent, and doesn't
scale. The Test Sentinel addresses this by providing automated, reliable
testing that catches bugs early and ensures code quality. It's particularly
valuable for teams working with complex tech stacks where manual testing would
be prohibitively time-consuming.
The skill's autonomous nature means it can work independently, fixing issues
as they arise and maintaining test coverage without constant human oversight.
This allows developers to focus on building features while the Test Sentinel
handles the quality assurance burden.
Skill can be found at:
sentinel/SKILL.md>
Top comments (0)