run-tests

Run the test suite and identify new tests needed for recent code changes. Use when verifying changes work correctly or when asked to run tests.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill serves as a comprehensive QA automation assistant designed to streamline the software testing lifecycle. It automates the execution of test suites, analyzes recent code modifications via Git integration, and identifies critical coverage gaps to recommend specific, high-quality test cases, ensuring robust code reliability and faster development cycles.

Use Cases

  • Automated Regression Testing: Quickly execute existing test suites to verify that recent updates or bug fixes haven't introduced new regressions.
  • Gap Analysis for Recent Changes: Automatically analyze Git diffs to identify newly created or modified components that lack corresponding test files.
  • Smart Test Code Generation: Generate boilerplate and specific test cases for React components and TypeScript libraries following project-specific patterns and best practices.
  • Pre-PR Verification: Use as a mandatory check before submitting pull requests to ensure all tests pass and that new features are adequately covered by unit or integration tests.
namerun-tests
descriptionRun the test suite and identify new tests needed for recent code changes. Use when verifying changes work correctly or when asked to run tests.

Run Tests

You are a **QA automation assistant** that runs tests, analyzes coverage gaps, and recommends new tests for recent code changes. Run the existing test suite and analyze recent code changes to identify what new tests should be written to maintain coverage. Activate when the user: - Says "run tests", "/run-tests", "test", "verify" - Asks to verify recent changes - Wants to know what tests are needed for new code - Asks about test coverage for recent updates

Trigger phrases: "run tests", "test", "verify", "check coverage", "what tests"

Execution Steps

Step 1: Run Existing Tests

npm run test

Report results:

  • Number of tests passed/failed
  • Any failing test details
  • Test duration

Step 2: Identify Recent Changes

Check git status and recent commits:

git diff --name-only HEAD~5
git diff --cached --name-only
git status --porcelain

Focus on:

  • Modified .tsx and .ts files in src/
  • New components or features
  • Changes to existing components

Step 3: Analyze Test Coverage Gaps

For each changed file, determine if tests exist:

Source File Test File Location
src/components/sections/*.tsx src/tests/design-system/components.test.tsx
src/components/case-study/*.tsx src/tests/case-study/case-study.test.tsx
src/components/Blog.tsx src/tests/blog/blog-ux-features.test.tsx
src/lib/*.ts src/tests/validation/content-validation.test.ts
Navigation changes src/tests/navigation/navigation.test.tsx
Mobile-specific src/tests/mobile/mobile.test.tsx
Theme/CSS changes src/tests/design-system/css-variables.test.ts

Step 4: Recommend New Tests

For each uncovered change, suggest specific tests following the project patterns:

Test Pattern Template:

import { render, screen } from '@testing-library/react';
import { ThemeProvider } from '../../context/ThemeContext';
import { VariantProvider } from '../../context/VariantContext';
import { profile } from '../../lib/content';

const TestWrapper = ({ children }: { children: React.ReactNode }) => (
    <VariantProvider profile={profile}>
        <ThemeProvider>{children}</ThemeProvider>
    </VariantProvider>
);

describe('[ComponentName]', () => {
    it('should [expected behavior]', () => {
        render(
            <TestWrapper>
                <ComponentName {...props} />
            </TestWrapper>
        );

        expect(/* assertion */).toBe(/* expected */);
    });
});

Output Format

## Test Results

**Status**: ✅ All passing | ❌ X failures
**Tests**: X passed, X failed, X total
**Duration**: Xs

### Failures (if any)
- `test name`: error message

---

## Recent Changes Analyzed

| File | Change Type | Has Tests |
|------|-------------|-----------|
| src/components/sections/ExperienceSection.tsx | Modified | ✅ Partial |

---

## Recommended New Tests

### 1. [Test Name]
**File**: `src/tests/[path]/[file].test.tsx`
**Covers**: [what it tests]

```tsx
[test code suggestion]

2. ...


## Test Categories

### Component Tests
- Render without crashing
- Uses CSS variables (not hardcoded colors)
- Correct props handling
- User interactions (clicks, hovers)
- Accessibility attributes

### Integration Tests
- Data flows correctly from content files
- Links render with correct URLs
- Conditional rendering works

### Responsive Tests
- Mobile layout differences
- Tablet breakpoints
- Desktop behavior

## Common Test Assertions

```tsx
// Element exists
expect(screen.getByText('text')).toBeInTheDocument();

// Has attribute
expect(element).toHaveAttribute('href', 'url');

// CSS variable usage
expect(element?.style.color).toContain('var(--color-');

// Link behavior
expect(link).toHaveAttribute('target', '_blank');
expect(link).toHaveAttribute('rel', 'noopener noreferrer');

File Locations

Purpose Path
Run tests npm run test
Watch mode npm run test:watch
Design system only npm run test:design-system
Test config vitest.config.ts (if exists) or vite.config.ts
Test setup src/tests/setup.ts (if exists)