test-specialist

Write tests, debug bugs, and analyze coverage for JavaScript and TypeScript applications.

2|1|Updated Jun 12, 2025
One-click install
npx skills add https://github.com/agent-trust-protocol/atp-core --skill test-specialist-agent-trust-protocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-specialist
Source: https://github.com/agent-trust-protocol/atp-core/tree/main/.claude/skills/test-specialist
Command: npx skills add https://github.com/agent-trust-protocol/atp-core --skill test-specialist-agent-trust-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing thorough tests and systematically tracking down bugs in JavaScript/TypeScript codebases is time-consuming, and coverage gaps often go unnoticed until production failures occur. ## Core Features & Use Cases - Test Authoring: Guides unit, integration, and end-to-end test writing using the AAA pattern, parameterized tests, and frameworks like Jest, Vitest, Playwright, and Supertest. - Systematic Bug Analysis: Applies a five-step process (reproduction, isolation, root cause, fix, validation) to diagnose race conditions, null reference errors, off-by-one errors, and security vulnerabilities. - Coverage Gap Detection: Ships Python scripts that parse Jest/Istanbul coverage reports and find source files lacking corresponding test files, prioritized by category. - Use Case: Run the find_untested_code.py script against your src directory to get a prioritized list of untested API, service, and component files, then generate tests for the highest-risk gaps. ## Quick Start Ask the assistant to analyze your project's test coverage and write unit tests for the untested service files it finds.

Frequently Asked Questions about test-specialist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find untested files in a JavaScript project?▼

Run the find_untested_code.py script against your source directory to list source files without matching test files. It categorizes untested files by type such as API, services, components, and hooks, and recommends which to prioritize.

How to analyze Jest coverage reports for gaps?▼

Generate coverage with npm test -- --coverage, then run analyze_coverage.py on the coverage-final.json file. The script reports statement, branch, and function percentages and lists files below the 80 percent threshold.

What testing frameworks does this skill support?▼

The guidance covers Jest or Vitest for unit and integration tests, Testing Library for React components, Supertest for API testing, and Playwright or Cypress for end-to-end tests. Coverage analysis targets Istanbul-format JSON reports.

How do I test for race conditions in async code?▼

Fire many concurrent operations with Promise.all and assert the final state matches the expected count. The references also describe adding deliberate delays to expose timing issues and testing state consistency after parallel dispatches.

What coverage threshold should TypeScript projects target?▼

The skill recommends 90 percent or higher for critical paths, 85 percent for business logic, 75 percent for UI components, and 70 percent for utilities. The coverage script flags any file falling below the configurable threshold.