Plain text

Skill jovd83/restassured-skill/documentation/test_cases/plain_text

Rest Assured skill pack for designing, implementing, documenting, and reporting API tests in Java and CI workflows.

Install

npx -y skills add jovd83/restassured-skill --skill plain_text

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 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 author says it does

Copied from the file, not written here

Legacy Rest Assured-specific alias for plain-text case formatting. Prefer the standalone `test-artifact-export-skill` skill for lightweight narrative case output, and use this only when Rest Assured-local conventions must be preserved explicitly.

SKILL.md

3.7 KB, as published. Nobody here has run it

Document Test Cases In Plain Text

1. Store And Organize Files

Store plain-text cases under docs/tests/<feature>/.
Create one .md or .txt file per scenario even in this lightweight mode.
Name files with the scenario purpose and classification, for example list-vets-mss.md or missing-owner-err.txt.
For non-trivial requirements, keep separate files for MSS, EXT, and ERR instead of mixing them into one narrative.
Use aggregate files under docs/testing/ only as indexes when the repo wants a summary.

2. Use This Lightweight Structure

Start with Title.
Add Purpose.
Add Covered requirement.
Add Preconditions.
Add Flow.
Add Expected outcome.
Add Test script.
Keep the wording concise, readable, and still traceable.

3. Content Rules

State the test goal clearly in the first sentence.
Mention any setup or auth state before the flow starts.
Describe the request flow in a logical sequence.
State the expected status, important headers, business fields, and side effects.
Link to the exact Java test method in Test script.
Keep the content API-specific. Do not use UI language.

4. Start From The Template

Start from plain-text-case-template.md for new lightweight scenario docs.
Keep the headings stable so traceability and documentation-sync work can recognize the file shape consistently.

5. Example

Title: [SPC-OWN-002] ERR: Missing owner lookup
Purpose: Capture the runtime behavior when a client requests an owner id that does not exist.
Covered requirement: GET /api/owners/{ownerId}, operationId=getOwner, SPC-OWN-002
Preconditions:
- The API is running.
- Owner id `999999` does not exist.
Flow:
- Send `GET /api/owners/999999`.
- Observe the returned status and payload behavior.
Expected outcome:
- The runtime returns status `404`.
- The mismatch report records that the documented problem-detail payload is not returned.
Test script: [OwnerReadApiTest.java](C:/repo/src/test/java/com/example/owner/OwnerReadApiTest.java)#missingOwnerReturnsBare404AtRuntime

6. Use Cases

Use this format for quick reviews or lightweight stakeholder alignment.
Use this format when the user rejects formal TDD or BDD structures.
Use this format when the team wants readable notes without losing traceability.

7. Troubleshooting

Problem: Important response details are missing. Fix: Add expected status, critical headers, business fields, and side effects explicitly.
Problem: The document becomes a vague paragraph with no traceability. Fix: Reintroduce Covered requirement and Test script explicitly.
Problem: One document covers too many behaviors. Fix: Split it into one scenario file per behavior, even in plain-text mode.