zephyr-scale

What This Skill Does

The zephyr-scale skill is a powerful OpenClaw agent capability designed to bridge the gap between your AI assistant and your Jira-based test management workflows. It acts as an interface for the Zephyr Scale (formerly TM4J) API, allowing users to programmatically manage, query, and report on software testing artifacts. Whether you need to synchronize test cases, track test cycle statuses, or associate requirements with specific test executions, this skill streamlines your QA operations by automating routine management tasks that would otherwise require navigating the Jira interface manually.

Installation

To integrate this skill into your environment, use the OpenClaw hub command: clawhub install openclaw/skills/skills/gora050/zephyr-scale. Once installed, ensure you have the Membrane CLI installed via npm install -g @membranehq/cli. You must authenticate your session using membrane login --tenant. To finalize the setup, locate the Zephyr Scale connector using membrane search zephyr-scale --elementType=connector --json and establish a connection with membrane connect --connectorId=YOUR_CONNECTOR_ID. Membrane will manage the lifecycle of your API tokens and authentication headers automatically.

Use Cases

This skill is ideal for QA leads, test engineers, and project managers looking to accelerate their release cycles. Common use cases include generating automated status reports for stakeholders by querying test cycle progress, bulk-updating test case priorities based on project requirements, or extracting data for custom dashboard visualizations. It is particularly effective in CI/CD pipelines where you need to report test results directly from your build process into Jira without manual data entry.

Example Prompts

1. "List all active test cycles in the current project and tell me how many tests are in a 'Pending' status."
2. "Find the test case with ID ZS-123 and update its priority to High."
3. "Create a summary report for the latest test execution run and export the failure rate."

Tips & Limitations

Always check your existing connections using membrane connection list --json before attempting to create a new one to avoid configuration duplication. When exploring specific capabilities, utilize the membrane action list command to view the input schemas for available actions, as this ensures your JSON payloads are formatted correctly for the Zephyr Scale API. Note that this skill is limited by the permissions assigned to your specific Jira account; ensure your user has appropriate access rights within the Jira project to modify test entities. Always verify that your project key is correctly referenced in your queries to prevent cross-project data contamination.