Agent skill

Testrail

by alirezarezvani in alirezarezvani/claude-skills

Sync tests with TestRail. An agent skill from alirezarezvani/claude-skills.

MITAuto-check passedTesting & QA

Install Testrail

skills CLI

$ npx skills add alirezarezvani/claude-skills --skill testrail -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install alirezarezvani/claude-skills testrail --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering-team/playwright-pro/skills/testrail .claude/skills/testrail && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "testrail" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/playwright-pro/skills/testrail into .claude/skills/testrail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "testrail", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/playwright-pro/skills/testrail

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add alirezarezvani/claude-skills --skill testrail -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install alirezarezvani/claude-skills testrail --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/engineering-team/playwright-pro/skills/testrail .agents/skills/testrail && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "testrail" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/playwright-pro/skills/testrail into .agents/skills/testrail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "testrail", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add alirezarezvani/claude-skills --skill testrail -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install alirezarezvani/claude-skills testrail --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/engineering-team/playwright-pro/skills/testrail .cursor/skills/testrail && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "testrail" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/playwright-pro/skills/testrail into .cursor/skills/testrail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "testrail", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/alirezarezvani/claude-skills.git --path engineering-team/playwright-pro/skills/testrail

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add alirezarezvani/claude-skills --skill testrail -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install alirezarezvani/claude-skills testrail --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/engineering-team/playwright-pro/skills/testrail .gemini/skills/testrail && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "testrail" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/playwright-pro/skills/testrail into .gemini/skills/testrail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "testrail", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install alirezarezvani/claude-skills testrail

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add alirezarezvani/claude-skills --skill testrail -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/engineering-team/playwright-pro/skills/testrail .github/skills/testrail && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "testrail" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/playwright-pro/skills/testrail into .github/skills/testrail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "testrail", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add alirezarezvani/claude-skills --skill testrail -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install alirezarezvani/claude-skills testrail --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/engineering-team/playwright-pro/skills/testrail .opencode/skills/testrail && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "testrail" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/playwright-pro/skills/testrail into .opencode/skills/testrail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "testrail", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: testrail
GitHub stars: 28k
Used in: 1 other repo
Token cost: ~966 tokens
SKILL.md length: 393 words
Files: 1
Skills in repo: 342
Repo updated: Aug 30, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Sync tests with TestRail. An agent skill from alirezarezvani/claude-skills.

Works in 5 steps: Import Test Cases → Generate Playwright… → Push Test Results → TestRail → Create Test Run → …
User mentions testrail
SKILL.md covers Prerequisites, Capabilities, MCP Tools Used and Test Annotation Format, plus 1 more section
Calls playwright, npx and npm; needs TESTRAIL_API_KEY

What it does

Testrail is an agent skill from alirezarezvani/claude-skills. Sync tests with TestRail. Use when user mentions "testrail", "test management", "test cases", "test run", "sync test cases", "push results to testrail", or "import from testrail".

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Test generation and MCP servers. It works with Playwright and Model Context Protocol. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

User mentions testrail
Test management
Sync test cases
Push results to testrail

Example prompts

“testrail”
“test management”
“test cases”
“/testrail”

Requirements

Node.js
A credential in TESTRAIL_API_KEY

Workflow steps

5 steps, taken from the step headings in SKILL.md.

Import Test Cases → Generate Playwright Tests
Push Test Results → TestRail
Create Test Run
Sync Status
Update Test Cases in TestRail

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- playwright
- npx
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- TESTRAIL_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Testrail loads about 966 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 393 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~47
When it runs · the whole SKILL.md, loaded when a task matches: ~966

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 393 words, ~966 tokens.

Download SKILL.mdSave it as .claude/skills/testrail/SKILL.md (or your agent's skills folder).

name: testrail
description: Sync tests with TestRail. Use when user mentions "testrail", "test management", "test cases", "test run", "sync test cases", "push results to testrail", or "import from testrail".

TestRail Integration

Bidirectional sync between Playwright tests and TestRail test management.

Prerequisites

Environment variables must be set:

TESTRAIL_URL — e.g., https://your-instance.testrail.io
TESTRAIL_USER — your email
TESTRAIL_API_KEY — API key from TestRail

If not set, inform the user how to configure them and stop.

The TestRail MCP server is not auto-registered (issue #978). pw-testrail was removed from the plugin's .mcp.json because it failed to connect for every user (the plugin ships no node_modules). The testrail_* MCP tools used below, and the /pw:testrail command, will fail with "tool not found" until it is enabled manually — see the Integrations section of the plugin's CLAUDE.md (cd integrations/testrail-mcp && npm install, then register the server in your own user/project MCP config). Setting the env vars alone is not sufficient.

Capabilities

1. Import Test Cases → Generate Playwright Tests

/pw:testrail import --project <id> --suite <id>

Steps:

Call testrail_get_cases MCP tool to fetch test cases
For each test case:
- Read title, preconditions, steps, expected results
- Map to a Playwright test using appropriate template
- Include TestRail case ID as test annotation: test.info().annotations.push({ type: 'testrail', description: 'C12345' })
Generate test files grouped by section
Report: X cases imported, Y tests generated

2. Push Test Results → TestRail

/pw:testrail push --run <id>

Steps:

Run Playwright tests with JSON reporter:

bash

npx playwright test --reporter=json > test-results.json

Parse results: map each test to its TestRail case ID (from annotations)
Call testrail_add_result MCP tool for each test:
- Pass → status_id: 1
- Fail → status_id: 5, include error message
- Skip → status_id: 2
Report: X results pushed, Y passed, Z failed

Show full SKILL.md (173 more words)Show less

3. Create Test Run

/pw:testrail run --project <id> --name "Sprint 42 Regression"

Steps:

Call testrail_add_run MCP tool
Include all test case IDs found in Playwright test annotations
Return run ID for result pushing

4. Sync Status

/pw:testrail status --project <id>

Steps:

Fetch test cases from TestRail
Scan local Playwright tests for TestRail annotations

Report coverage:

TestRail cases: 150
Playwright tests with TestRail IDs: 120
Unlinked TestRail cases: 30
Playwright tests without TestRail IDs: 15

5. Update Test Cases in TestRail

/pw:testrail update --case <id>

Steps:

Read the Playwright test for this case ID
Extract steps and expected results from test code
Call testrail_update_case MCP tool to update steps

MCP Tools Used

Tool	When
`testrail_get_projects`	List available projects
`testrail_get_suites`	List suites in project
`testrail_get_cases`	Read test cases
`testrail_add_case`	Create new test case
`testrail_update_case`	Update existing case
`testrail_add_run`	Create test run
`testrail_add_result`	Push individual result
`testrail_get_results`	Read historical results

Test Annotation Format

All Playwright tests linked to TestRail include:

typescript

test('should login successfully', async ({ page }) => {
  test.info().annotations.push({
    type: 'testrail',
    description: 'C12345',
  });
  // ... test code
});

This annotation is the bridge between Playwright and TestRail.

Output

Operation summary with counts
Any errors or unmatched cases
Link to TestRail run/results

Files

Just SKILL.md in engineering-team/playwright-pro/skills/testrail of alirezarezvani/claude-skills.

Open the folder on GitHubat commit 19392f7

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in alirezarezvani/claude-skills, which our catalogue first saw on October 7, 2026.

LeoYeAI/openclaw-master-skillsskills/playwright-pro/skills/testrail skills/cs-playwright-pro/skills/testrail

Compare with similar skills

Testrail next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Testrail compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Testrail this skillalirezarezvani/claude-skills	28k	1 repos	~966	Automated safety check: Pass	MIT	1 mo ago
Frontmcp Testingagentfront/frontmcp	146	—	~10k	Automated safety check: Notes	Apache-2.0	yesterday
Chatgpt App Submissionnteract/semiotic	2.7k	—	~2.8k	Automated safety check: Pass	Apache-2.0	yesterday
Glance TestDebugBase/glance	156	—	~827	Automated safety check: Pass	MIT	5 mo ago
Ue Test AuthoringJasonMa0012/MooaToon	749	—	~2.1k	Automated safety check: Notes	Custom licence	20 days ago
Windows QA EngineerCodeAlive-AI/ai-driven-development	157	—	~1.4k	Automated safety check: Pass	MIT	2 days ago

Similar skills

Frontmcp Testing
agentfront/frontmcp
A skill your agent uses for anything about testing FrontMCP servers: writing or running unit, integration, and E2E tests and reaching the 95%+ coverage bar.
146 GitHub stars~10k tokensUpdated yesterday
Testing & QAAuto-check: notes
Chatgpt App Submission
nteract/semiotic
Inspect a ChatGPT Apps MCP server codebase and generate chatgpt-app-submission.json with app info suggestions, tool hint justifications, test cases, and negative test cases, then report review-check…
2.7k GitHub stars~2.8k tokensUpdated yesterday
Testing & QAAuto-check passed
Glance Test
DebugBase/glance
Run E2E browser tests on any web application using Glance MCP.
156 GitHub stars~827 tokensUpdated 5 mo ago
Testing & QAAuto-check passed
Ue Test Authoring
JasonMa0012/MooaToon
A skill your agent uses when writing or modifying UE automated tests (Automation, CQTest, Functional, Gauntlet, LowLevel) with Rider MCP available.
749 GitHub stars~2.1k tokensUpdated 20 days ago
Testing & QAAuto-check: notes
Windows QA Engineer
CodeAlive-AI/ai-driven-development
A skill your agent uses when testing Windows 11 desktop apps (WinForms/WPF/UWP) via UFO UIA/Win32 automation MCP.
157 GitHub stars~1.4k tokensUpdated 2 days ago
Testing & QAAuto-check passed
Mirroir Onboard
jfarcand/mirroir-mcp
Onboard a consumer web app to mirroir's .mirroir/ dotfile by EXPLORING the running app (chrome-devtools-mcp) — derive real selectors from the accessibility tree, exercise each surface's primary…
245 GitHub stars~4.4k tokensUpdated 2 days ago
Testing & QAAuto-check: notes

More from alirezarezvani/claude-skills

All 342 skills in this repo

Agile Product Owner
alirezarezvani/claude-skills
Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.
28k GitHub starsUsed in 3 repos~3.2k tokens
Auto-check passed
Product Strategist
alirezarezvani/claude-skills
OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.
28k GitHub starsUsed in 2 repos~1.8k tokens
Auto-check passed
App Store Optimization
alirezarezvani/claude-skills
App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.
28k GitHub starsUsed in 1 repo~4.2k tokens
Auto-check passed
AWS Solution Architect
alirezarezvani/claude-skills
Design AWS architectures for startups using serverless patterns and IaC templates.
28k GitHub starsUsed in 1 repo~2.5k tokens
Auto-check passed
Campaign Analytics
alirezarezvani/claude-skills
Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.
28k GitHub starsUsed in 1 repo~2.1k tokens
Auto-check passed
Code to PRD
alirezarezvani/claude-skills
Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.
28k GitHub starsUsed in 1 repo~4.9k tokens
Auto-check passed

Works with

Questions about Testrail

What does Testrail do?

Sync tests with TestRail. An agent skill from alirezarezvani/claude-skills. Testrail is an agent skill from alirezarezvani/claude-skills. Sync tests with TestRail.

When should I use Testrail?

Testrail fits situations like: user mentions testrail; test management; sync test cases; push results to testrail.

How do I install Testrail in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill testrail -a claude-code`. Or copy the skill folder (engineering-team/playwright-pro/skills/testrail in alirezarezvani/claude-skills) into .claude/skills/testrail in your project. Claude Code loads it when a task matches its description.

How do I install Testrail in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill testrail -a codex`. Or copy the skill folder (engineering-team/playwright-pro/skills/testrail in alirezarezvani/claude-skills) into .agents/skills/testrail in your project. Codex loads it when a task matches its description.

Can I use Testrail in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill testrail -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/testrail, .gemini/skills/testrail, .github/skills/testrail and .opencode/skills/testrail in your project.

What does Testrail need to run?

Going by SKILL.md and its folder, Testrail needs the command-line tools its instructions call (playwright, npx and npm) and credentials named TESTRAIL_API_KEY. Our summary lists: Node.js; A credential in TESTRAIL_API_KEY.

Does Testrail access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Testrail safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Testrail use?

Testrail is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Testrail use?

About 966 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Testrail?

Skills that share tags, products or a category with Testrail: Frontmcp Testing (agentfront/frontmcp, 146 stars), Chatgpt App Submission (nteract/semiotic, 2.7k stars), Glance Test (DebugBase/glance, 156 stars) and Ue Test Authoring (JasonMa0012/MooaToon, 749 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Testrail?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,829 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Testrail

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

TestRail Integration

Prerequisites

Capabilities

1. Import Test Cases → Generate Playwright Tests

2. Push Test Results → TestRail

3. Create Test Run

4. Sync Status

5. Update Test Cases in TestRail

MCP Tools Used

Test Annotation Format

Output

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from alirezarezvani/claude-skills

Related

Questions about Testrail