> For the complete documentation index, see [llms.txt](https://mycroft-ai.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mycroft-ai.gitbook.io/docs/skill-development/voice-user-interface-design-guidelines/prototyping.md).

# Prototyping

As the skill designer you will act as the Voice Assistant and respond to the user's input with pre-written [Example Interations](/docs/skill-development/voice-user-interface-design-guidelines/example-dialogs.md) that you have created. You can think of it like a table read for a screenplay except the user is ad-libbing. Make sure you ask your participants if it is alright to record the sessions so that you can take better notes after the test is complete.&#x20;

As the part of the Voice Assistant you want to stick to the script, but you are actually hoping the tester says something that you haven't thought of yet. The goal of these tests isn't to just validate your assumptions, the goal is to observe interactions that did not occur to you at first.

To begin the test give the user a task. For example, with the Moon Phase skill, we can pull the task directly from our Jobs to be done work.&#x20;

**Task Example:**

> *You're thinking about taking some photos of the moon tonight, and you want to know what phase the moon will be in. What would you ask Mycroft to help you plan your photo session?*

The first off the cuff responses from your test are generally the best, but it's always good to ask your testers if they can provide any variations on the way they might ask the question.

Be considerate of your tester's time. A usability test should never exceed 90 minutes, after that [the test subject will likely get tired](https://www.nngroup.com/articles/time-budgets-for-usability-sessions/). We think you can get valuable feedback in a 30 to 45 minute session.

If you are creating a Skill as a hobby or as an individual you may not have the resources to provide an incentive to your testers. In that case you might be limited to friends and family for testing. If you are creating a skill for a larger organisation make sure that you think about possible incentives and check if your organisation requires a legal waiver for user testing.

&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mycroft-ai.gitbook.io/docs/skill-development/voice-user-interface-design-guidelines/prototyping.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
