revyl-mcp-create

name	revyl-mcp-create
description	Create and maintain Revyl tests through MCP tools using create/update operations and execution feedback loops.

Revyl MCP Create Skill

Use this skill when tests should be authored and managed through MCP tools.

Core MCP Flow

1. Build YAML from ordered instructions and validations.
2. Create or update:
   • create_test(name="...", platform="ios", yaml_content="...")
   • update_test(test_name_or_id="...", yaml_content="...", force=true)
3. Execute and inspect:
   • run_test(test_name="...")
   • get_test_status(task_id="...")

Authoring Rules

1. One action per instruction step.
2. Keep validations separate from instructions.
3. Validate user-visible outcomes.
4. Use variables for sensitive or dynamic values.

Canonical YAML

Use the backend YAML contract returned by get_schema().

- type: instructions
  step_description: "Tap Log in."

- type: validation
  step_description: "The dashboard is visible."

- type: code_execution
  script: "seed-user"
  variable_name: seeded_user_id

- type: module_import
  module: "login-flow"

- type: if
  condition: "Is a cookie banner visible?"
  then:
    - type: instructions
      step_description: "Tap Accept."
  else:
    - type: instructions
      step_description: "Continue."

- type: while
  condition: "Is there a Load More button visible?"
  body:
    - type: instructions
      step_description: "Tap Load More."

For new authored YAML, use script for code execution and module for module imports. Legacy UUID forms may still parse for compatibility, but do not generate them.

Shared Setup Reuse

If shared steps appear in 3+ tests:

1. list_modules()
2. insert_module_block(module_name_or_id="...")
3. update test YAML to import module.