sdk-e2e-create

Plans and scaffolds e2e tests for new or changed public SDK APIs.

Updated May 11, 2026
One-click install
npx skills add https://github.com/thachrocky12345/local-agent-train-workstation --skill sdk-e2e-create-thachrocky12345
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdk-e2e-create
Source: https://github.com/thachrocky12345/local-agent-train-workstation/tree/main/qvac/.cursor/skills/sdk-e2e-create
Command: npx skills add https://github.com/thachrocky12345/local-agent-train-workstation --skill sdk-e2e-create-thachrocky12345

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding or changing a public SDK API requires consistent end-to-end test coverage, but writing those tests by hand often leads to weak assertions, missing error paths, wrong executor placement, and unverified smoke tags. This Skill enforces a structured workflow so every public API change ships with happy, sad, and error coverage that is validated locally before landing. ## Core Features & Use Cases - Test planning and scaffolding: Investigates the changed SDK surface, finds comparable existing tests, and drafts concrete test definitions plus executors in packages/sdk/tests-qvac. - Deterministic model-output assertions: Selects the strongest achievable validation strategy (contains-all, contains-any, regex, numeric-range, throws-error) instead of defaulting to weak shape-only checks. - Placement and mobile constraints: Decides shared, desktop, or mobile executor placement and addresses memory, filesystem, and platform-specific limitations with SkipExecutor entries when needed. - Use Case: After adding a new translation function to the SDK, invoke the skill to generate test definitions, register executors, pick one smoke candidate, and receive the exact run:local:desktop --filter command to verify the tests pass. ## Quick Start Ask the assistant to add e2e tests for the new SDK feature you just implemented in packages/sdk.

Frequently Asked Questions about sdk-e2e-create

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add e2e tests for a new SDK feature?

Invoke the skill after changing the public SDK API. It reads the feature code, finds comparable tests in tests/test-definitions.ts, drafts happy, sad, and error test definitions, scaffolds executors, and gives you the exact run:local:desktop --filter command to verify.

How do I write deterministic assertions for model output in e2e tests?

Constrain the prompt with temperature 0, fixed seed, or top_k 1 so a known token must appear, then assert with contains-all. Fall back to closed-set contains-any, numeric-range, or anchored regex; use type-only shape checks only as a flagged last resort.

Where should SDK e2e test executors be placed for desktop vs mobile?

Pure SDK API calls go in tests/shared/executors. Anything needing node:fs, node:path, or process.cwd() goes in tests/desktop/executors, and React Native or Platform-specific code goes in tests/mobile/executors. Never import node:* from shared or mobile.

When should an e2e test be tagged with the smoke suite?

Tag suites smoke only when the feature has no existing smoke coverage, capping at one or two tests. Pick the happy path with the strongest deterministic assertion, and verify it runs fast and stable on both desktop and mobile before tagging.

What if an SDK feature cannot run on mobile devices?

Add a SkipExecutor at the top of tests/mobile/consumer.ts with a clear reason such as insufficient device RAM, missing native library, or unsupported backend. Document the skip in the plan and ship desktop-only coverage.

When should this skill not be used for SDK testing?

Do not use it for internal refactors that leave the public API surface unchanged, or for unit tests inside packages/sdk. It covers only the e2e suite under packages/sdk/tests-qvac for consumer-facing API changes.