skills.rest
grad13
grad13COMMUNITY
Explore all skills by this author →
GitHub

tests-to-spec

Synchronize TypeScript test files with specification files by classifying discrepancies into cases A-E.

Updated Jun 21, 2025
Search Tags:#typescript#testing#documentation#refactoring#specification#code synchronization
One-click install
npx skills add https://github.com/grad13/cctop --skill tests-to-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tests-to-spec
Source: https://github.com/grad13/cctop/tree/main/.claude/skills/tests-to-spec
Command: npx skills add https://github.com/grad13/cctop --skill tests-to-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses inconsistencies between test files and their corresponding specification files, ensuring code documentation and functionality remain aligned.

Core Features & Use Cases

  • Identify & Classify Discrepancies: Detects and categorizes issues between tests and specs into five distinct cases (A-E).
  • Automated Spec Generation/Modification: Generates new specs, modifies existing ones, or corrects mapping issues based on test file analysis.
  • Use Case: When refactoring code, tests might evolve independently of their documentation (specs). This skill helps automatically update the specs to accurately reflect the current state of the tests, preventing outdated documentation.

Quick Start

Use the tests-to-spec skill to synchronize test files with their corresponding specification files.

Frequently Asked Questions about tests-to-spec

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

FAQPage Schema
How do I synchronize TypeScript test files with specification documents?▼

Synchronizing TypeScript test files with specification documents involves analyzing the tests to automatically generate, modify, or correct mapping issues in spec-v2.1 files. This process classifies discrepancies into five distinct cases.

What is the best way to update outdated specs after refactoring code?▼

Updating outdated specs after refactoring requires automatically analyzing the evolved test files to detect inconsistencies. The system then categorizes these discrepancies and modifies the existing specification files to accurately reflect the current test state.

Does synchronizing tests with specifications require Git operations?▼

Yes, synchronizing tests with specifications requires Git operations for checkpointing and tagging. These version control actions are necessary to manage the automated generation and modification of the specification files during the synchronization process.

How does identifying and classifying test and spec discrepancies work?▼

Identifying and classifying test and spec discrepancies works by processing TypeScript test files and categorizing inconsistencies into five specific cases, labeled A through E. This classification dictates whether the system generates, modifies, or maps the specification files.

Can I use this specification synchronization process for non-TypeScript test files?▼

No, this specification synchronization process is designed specifically for TypeScript test files. It processes TypeScript code to generate or update spec-v2.1 documents and does not support non-TypeScript formats based on its current design.

Related Skills

Explore More Software Engineering Skills→
chaimtchaimt

speckit-git-initialize

Initialize a Git repository with an initial commit in the current directory.

Community
Intermediate
rstackjsrstackjs
86

rspress-v2-upgrade

Migrate Rspress v1 projects to v2 by updating dependencies, configs, and themes.

Official
Advanced
nguyenphpnguyenphp
41

lint-and-validate

Run linters, type checkers, and security audits across Node.js and Python projects.

Community
Intermediate
Lands-1203Lands-1203
40

f2s-doc-arch

Generate project architecture description drafts from documentation or code.

Community
Intermediate