| name | cypress-mapper-testrail |
| description | Test-management mapping skill for TestRail. Use when Codex needs to apply authoritative TestRail case IDs back into local Cypress docs, titles, or annotations so the repository can trace automation to imported TestRail records. |
| metadata | {"author":"jovd83","version":"1.1","dispatcher-category":"testing","dispatcher-capabilities":"test-management-mapping, cypress-test-management-mapping","dispatcher-accepted-intents":"map_cypress_test_management_ids","dispatcher-input-artifacts":"test_management_ids, local_artifacts, repo_context","dispatcher-output-artifacts":"mapped_traceability_artifacts, mapping_report","dispatcher-stack-tags":"cypress, mapping, test-management","dispatcher-risk":"low","dispatcher-writes-files":true} |
Telemetry & Logging
[!IMPORTANT]
All usage of this skill must be logged via the Skill Dispatcher to ensure audit logs and wallboard analytics are accurate:
./log-dispatch.cmd --skill <skill_name> --intent <intent> --model <model_name> --reason <reason> (or ./log-dispatch.sh on Linux)
TestRail Mapper
Use this skill after TestRail has assigned IDs and the local repository needs to reflect them.
Action
Inputs:
- an authoritative mapping from local scenario names or paths to TestRail IDs,
- the target markdown or automation files,
- the team convention for where IDs belong in docs or test titles.
Output contract:
- updated local docs or code references,
- a summary of which IDs were applied where,
- any ambiguous matches that still need human confirmation.
Guardrails:
- Do not invent IDs.
- Do not overwrite an existing different ID without calling out the conflict.
- Prefer annotations or title conventions already used by the repository.
