How do I install the Tc Review skill?

Run npx skillmds@latest add diegosouzapw/tc-review in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tc Review safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tc Review?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tc Review free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tc Review?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tc Review by diegosouzapw — Agent Skill

Name: Tc Review
Rating: 4.2 (5 reviews)
Author: diegosouzapw

Tc Review

Review QA test case documents (Markdown) against source code to find coverage gaps. Use when reviewing test cases, analyzing test coverage, suggesting missing scenarios, or learning codebase to extract testable scenarios. Supports project-based learning from multiple GitHub repos with dual memory (local + Dify RAG).

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

Test Case Review

Review test case documents against source code knowledge. Learn codebases, identify coverage gaps, suggest missing test cases.

Quick Start

# 1. Create project and add repos
python scripts/setup_project.py myproject https://github.com/org/repo.git

# 2. Review test cases
python scripts/review.py tests/checkout.md --project myproject

Decision Tree

User task → What do they need?
    │
    ├─ Review test cases → Is project set up?
    │   ├─ No → Run: python scripts/setup_project.py <name> <repo-url>
    │   └─ Yes → Run: python scripts/review.py <testcase.md> --project <name>
    │
    ├─ Learn new codebase → Run: python scripts/learn.py <project>
    │
    ├─ Get suggestions → Run: python scripts/suggest.py <project>
    │
    └─ Search knowledge → Run: python scripts/search.py <project> "<query>"

Available Scripts

Always run with --help first to see usage. Scripts handle complex workflows reliably.

Script	Purpose
`scripts/setup_project.py`	Create project + add repo + learn (all-in-one)
`scripts/review.py`	Review test case file against knowledge
`scripts/learn.py`	Learn/re-learn source code from repos
`scripts/suggest.py`	Generate test case suggestions
`scripts/search.py`	Search project knowledge
`scripts/batch_review.py`	Review multiple files at once

Test Case Format

Test cases must be Markdown. See references/testcase-format.md for complete guide.

# Test Suite: Payment Flow

## TC-001: Successful Payment
**Preconditions:**
- User logged in
- Cart has items

**Steps:**
1. Navigate to checkout
2. Enter valid card
3. Click Pay

**Expected Result:**
Payment success, order created

Example Workflows

Review Single File

python scripts/review.py tests/login.md --project auth-service

Output:

📊 Score: 65/100  Coverage: 65%

✅ Covered: Successful login, Invalid password
⚠️ Missing: Account locked, Rate limiting, Session timeout
💡 Suggested: TC-005 Account Lockout, TC-006 Rate Limit

Batch Review

python scripts/batch_review.py "tests/**/*.md" --project myapp --min-score 70

Quick Review (No Project Setup)

python scripts/setup_project.py temp-project https://github.com/org/repo.git
python scripts/review.py tests/feature.md --project temp-project

Environment Variables

Variable	Required	Description
`ANTHROPIC_API_KEY`	Yes*	For Claude LLM
`OPENAI_API_KEY`	Yes*	For OpenAI/Codex
`LLM_PROVIDER`	No	`anthropic` or `openai` (default: anthropic)
`LLM_MODEL`	No	Model name
`DIFY_API_KEY`	No	Enable Dify RAG
`DIFY_DATASET_ID`	No	Dify dataset ID

*One of ANTHROPIC_API_KEY or OPENAI_API_KEY required.

Reference Files

testcase-format.md - Complete test case writing guide
scenarios.md - Test scenario types and examples
troubleshooting.md - Common issues and solutions

---name: tc-reviewdescription: Review QA test case documents (Markdown) against source code to find coverage gaps. Use when reviewing test cases, analyzing test coverage, suggesting missing scenarios, or learning codebase to extract testable scenarios. Supports project-based learning from multiple GitHub repos with dual memory (local + Dify RAG).---# Test Case ReviewReview test case documents against source code knowledge. Learn codebases, identify coverage gaps, suggest missing test cases.## Quick Start```bash# 1. Create project and add repospython scripts/setup_project.py myproject https://github.com/org/repo.git# 2. Review test casespython scripts/review.py tests/checkout.md --project myproject```## Decision Tree```User task → What do they need? │ ├─ Review test cases → Is project set up? │ ├─ No → Run: python scripts/setup_project.py <name> <repo-url> │ └─ Yes → Run: python scripts/review.py <testcase.md> --project <name> │ ├─ Learn new codebase → Run: python scripts/learn.py <project> │ ├─ Get suggestions → Run: python scripts/suggest.py <project> │ └─ Search knowledge → Run: python scripts/search.py <project> "<query>"```## Available Scripts**Always run with `--help` first** to see usage. Scripts handle complex workflows reliably.| Script | Purpose ||--------|---------|| `scripts/setup_project.py` | Create project + add repo + learn (all-in-one) || `scripts/review.py` | Review test case file against knowledge || `scripts/learn.py` | Learn/re-learn source code from repos || `scripts/suggest.py` | Generate test case suggestions || `scripts/search.py` | Search project knowledge || `scripts/batch_review.py` | Review multiple files at once |## Test Case FormatTest cases must be Markdown. See [references/testcase-format.md](references/testcase-format.md) for complete guide.```markdown# Test Suite: Payment Flow## TC-001: Successful Payment**Preconditions:**- User logged in- Cart has items**Steps:**1. Navigate to checkout2. Enter valid card3. Click Pay**Expected Result:**Payment success, order created```## Example Workflows### Review Single File```bashpython scripts/review.py tests/login.md --project auth-service```Output:```📊 Score: 65/100 Coverage: 65%✅ Covered: Successful login, Invalid password⚠️ Missing: Account locked, Rate limiting, Session timeout💡 Suggested: TC-005 Account Lockout, TC-006 Rate Limit```### Batch Review```bashpython scripts/batch_review.py "tests/**/*.md" --project myapp --min-score 70```### Quick Review (No Project Setup)```bashpython scripts/setup_project.py temp-project https://github.com/org/repo.gitpython scripts/review.py tests/feature.md --project temp-project```## Environment Variables| Variable | Required | Description ||----------|----------|-------------|| `ANTHROPIC_API_KEY` | Yes* | For Claude LLM || `OPENAI_API_KEY` | Yes* | For OpenAI/Codex || `LLM_PROVIDER` | No | `anthropic` or `openai` (default: anthropic) || `LLM_MODEL` | No | Model name || `DIFY_API_KEY` | No | Enable Dify RAG || `DIFY_DATASET_ID` | No | Dify dataset ID |*One of ANTHROPIC_API_KEY or OPENAI_API_KEY required.## Reference Files- [testcase-format.md](references/testcase-format.md) - Complete test case writing guide- [scenarios.md](references/scenarios.md) - Test scenario types and examples- [troubleshooting.md](references/troubleshooting.md) - Common issues and solutions

Frequently asked questions