Improve test cases
Analyze and improve existing markdown manual test cases for clarity, structure, and Test Management Tool format compliance.From its SKILL.md
npx -y skills add testomatio/skills --skill improve-test-casesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 19 stars19 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.3 KB, as published. Nobody here has run it
Improve Test Cases
Analyze and improve existing markdown manual test cases to make them clearer for the QA team:
- Improve test titles for clarity.
- Enhance test descriptions.
- Fix broken formatting and markdown syntax.
- Standardize test structure to Test Management Tool format.
- Ensure consistent terminology and language.
- Update tags and labels.
DO NOT CHANGE:
- Original test/suite IDs.
- Original test intent.
- Original language (fix only clarity, grammar, typos).
Step 1: Locate Test Files
- Find markdown test files (
.test.mdor.md) in common locations:./manual-tests,./tests/manual,./docs/tests. - If none found, scan the whole project for
.mdfiles with test case content. - If still none, ask the user for the test directory path.
Step 2: Analyze Test Quality
Read each test and flag issues:
Titles:
- Unclear or vague test title.
- Missing action-object format.
- Not specific enough to understand what is being tested.
Descriptions:
- Vague or unclear test purpose.
- Missing or incomplete description.
Steps and expected results:
- Missing expected results.
- Inconsistent step format.
- Unclear actions.
- Steps not ordered logically.
- Expected results not relevant to the steps.
- Missing pass/fail criteria.
Formatting:
- Broken markdown syntax.
- Missing sections.
- Inconsistent header hierarchy.
Ambiguity:
- Generic or subjective terms ("should work", "might fail").
- Vague language that could be interpreted multiple ways.
- Steps that cannot be verified objectively.
- Missing specific values, data, or conditions.
Step 3: Show Summary to User
- List issues found per test.
- Give specific recommendations for improvements.
- Ask the user to confirm before proceeding.
- If the user does not confirm, do not change anything.
Step 4: Improve Tests
Titles:
- Make clear and specific.
- Use action-result format: "Verify [action] results in [expected]".
- Ensure the title reflects the actual test purpose.
Descriptions:
- Make purpose clear and concise.
- Include context from the parent suite when relevant.
- Fix grammar and spelling only.
Steps:
- Give each step an explicit expected result.
- Nested format: "- Step action..." with indented "Expected: ...".
- Make actions specific and reproducible.
- Add measurable pass/fail criteria.
- Ensure results are directly relevant to the step action.
- Make results measurable and verifiable.
- Avoid vague terms; use specific values and conditions.
Ambiguity:
- Replace generic terms with specific, testable language.
- Avoid subjective terms ("should work", "might fail").
- Ensure steps can be verified objectively.
Metadata:
- Set
type: manualin test metadata. - Use only these priority values:
low,normal,important,high,critical.
Step 5: Save Changes
- Overwrite the original files.
- Keep the same file names and directory structure.
- Preserve all original test/suite IDs.
Step 6: Show Final Summary
- Number of files modified.
- Number of tests improved.
- Key improvements made.
Reference
TMS markdown format example: references/TESTOMAT_MARKDOWN_EXAMPLE.md