aktonay/skillz / skills/cursor-tools/walkthrough-artifacts
walkthrough-artifacts
VerifiedCreate walkthrough artifacts (screenshots and screen recordings) that prove code changes work. Use when finishing tested changes and uploading demo evidence for the user.
Creating & Uploading Walkthrough Artifacts
When your changes are complete, and you have completed testing / validation, you MUST demonstrate to the user that your changes are working.
If the user explicitly requested specific manual testing, you MUST also demonstrate that you fulfilled their request.
Do this with walkthrough artifacts. Follow this rubric, then include HTML-tag references to the artifacts inline in your final response to the user.
When to Use
Use walkthrough artifacts to: (1) demonstrate that your code changes work correctly, and (2) show that any user-requested manual testing was completed.
What makes a good test artifact
Good walkthrough artifacts clearly show the user that your code is fully working and any specifically requested testing was completed. Examples:
- A screenshot of an implemented UI change
- A screen recording of changes working end-to-end
- A screen recording or screenshot showing that user-requested testing was performed
The following are examples of bad walkthrough artifacts and should NOT be uploaded:
- A screen recording of a test which ultimately did not succeed. Instead of saving the video, you should fix the failure and retry!
- Numerous screenshots of unimportant setup steps, app exploration, or failing testing steps. You may take these screenshots during testing, but do NOT upload them as artifacts.
- Redundant walkthrough artifacts which show something that a different artifact of the same type already shows.
- A toy artifact or fake / contrived example to "demonstrate" working code. NEVER create toy artifacts or fake / contrived examples.
RULE: Upload the minimal set of artifacts that demonstrates your changes fully work and that all user requests were fulfilled. Videos are often helpful for showing end-to-end tests with fewer artifacts.
Examples of good artifact sets:
- One screenshot showing the final state after testing, and 1 or 2 screen recordings which begins right before demonstrating a working test and ends right after.
- A few screenshots showing the before, during, and after state during your manual tests.
- One screenshot showing key pre-test setup (e.g. altering the application settings, switching the mode, or selecting a specific model), and one screenshot or showing the after test state (or one video showing end-to-end test, minus lengthy setup steps)
If the user requested specific testing (e.g. reproducing a bug before fixing, specific setup steps, testing a feature in a particular way, etc.), you must include clearly-labeled artifacts showing that you completed the user's request(s).
Remember: the set of uploaded artifacts must demonstrate BOTH that your code successfully implements the user's request AND that any user-requested testing was completed. Some artifacts may show that both are true, and others may show only one or the other.
Examples of bad sets of artifacts to upload (DO NOT UPLOAD ARTIFACTS LIKE THIS):
- A screenshot before and/or after every testing step
- Screenshots of irrelevant application state, e.g. pre-test state, or state after the relevant portion of the application has been exited or scrolled offscreen.
- Screenshots or videos showing failing tests. Fix these and retry! Do not upload!
- Redundant screenshots which show the same or very similar application states.
- Very lengthy videos which include irrelevant devex setup or application setup state. Start your recording right before the test begins!
Creating an artifact
Screenshot artifacts
When you are using the computerUse subagent, it will return screenshots showing key application states. Remember these screenshot paths for future use. You should review all available artifacts at the end of your tests and decide which ones best demonstrate the correctness of your code. Show these top artifacts to the user.
Video artifacts
Video walkthroughs of working features are often the most effective way to demonstrate the correctness of your changes. When you are performing manual GUI-based testing, you MUST include a video artifact.
How to create a video artifact:
- Setup the manual test environment. This means using the
computerUsesubagent to make sure the UI is open, and navigated to the correct page or feature to demonstrate the working change(s). - Begin a recording using the
RecordScreentool with mode set toSTART_RECORDING. - Perform the manual test that demonstrates the working change(s) using the
computerUsesubagent. Provide detailed instructions for the subagent to follow. - Immediately after the
computerUsesubagent responds, end the video recording. If the walkthrough was successful: save the recording to your artifacts directory by using theRecordScreentool with mode set toSAVE_RECORDING(this will also stop the recording). If the walkthrough was unsuccessful: discard the recording by using theRecordScreentool with mode set toDISCARD_RECORDING. Debug why the walkthrough attempt did not succeed, fix the issue, and retry.
Correct process for creating a video artifact: start recording, start computerUse subagent with detailed instructions, end recording.
Critical Rules:
- Always end your recording right after your manual test(s) end. If debugging, additional setup, resetting state, or other non-testing steps are required between multiple tests, split the multiple tests into multiple recordings.
Saving an artifact
To save a screenshot, copy the screenshot to your artifacts directory (the absolute path named in the system prompt's testing requirements). It is probably advantageous to review and select the most relevant screenshots at the end of your testing.
Screen recordings are auto-saved to that same artifacts directory when RecordScreen is called with mode=SAVE_RECORDING. Only use mode=SAVE_RECORDING when you want the recording to be a user-facing artifact.
Before referencing video artifacts in your response, use the videoReview subagent to verify your understanding of what the video shows.
All files placed in that folder will be automatically uploaded when you finish your work and will be visible by the user in the Cursor web app.
Details
- Give files descriptive (but short) names in snake_case, such as screenshot_button_color_before.png and screenshot_button_color_after.png, to help the user understand what the files are.
- For video files, the file name MUST describe the contents of the entire video, not just a part of it.
- Artifact files are immutable and cannot be edited or deleted once uploaded. Don't try to edit or overwrite artifact files, always add a new file in the directory with a unique name.
- All file types are supported.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |