When you add Assistants to your document, they’ll check your designs against a set of rules and let you know if they spot issues or inconsistencies. In the Assistants results window, you can filter through issues, quickly find the layer they relate to, and fix them.
Installing and managing Assistants
You can add multiple Assistants to any document. You might have one that covers your company’s design system, another for accessibility and another for document organization, for example.
You’ll need to add Assistants on a per-document basis, but they will stay attached to that document when you share it with others. If someone doesn’t have an Assistant your document uses, they’ll be prompted to install it.
When you add an Assistant to a document, it will be available to use in any other document you create in the future, you’ll just need to enable it first.
You can read more about how to install and manage Assistants in the Document Settings documentation.
Working with Assistants
When you’ve installed and enabled Assistants in your document, they’ll check it for any issues or inconsistencies against the set of the rules they’ve been built to follow. By default, Assistants run automatically and should update their results after you make changes in your document.
To stop Assistants from automatically checking your document choose File > Assistants > Check Document Automatically from the menu bar to toggle this option off. With automatic checking switched off, you’ll need to choose File > Assistants > Check Document Now (or press ⌘⇧B) any time you want Assistants to update their results.
When the Assistants you’ve added to your document check it and spot issues, they’ll display a notification badge next to the Assistants toolbar item . Clicking on the toolbar item will bring up the Assistants results window and show you a list of every issue in your document. When you fix an issue, Assistants will check your document again and you should see it disappear from the results list.
You can also show and hide the Assistants results window at any time by choosing View > Show/Hide Assistants or press ⌘⌥3.
Here’s what you’ll see in the results window:
- Each Assistant has its own thumbnail and a notification badge with the current number of issues it has found. Clicking on these thumbnails filters the results list to show only issues from the Assistant you’ve selected. Clicking the leftmost thumbnail will reset the view and show you issues from all Assistants.
- The circle icon gives you access to the Document Settings window, settings to show or hide ignored rules, and a link to open the Assistants directory.
- Each issue in the results list is collapsible (handy if you have a lot to look through!) and hovering over it will reveal a
?icon. Clicking on this will open a browser window with documentation for that specific rule from the Assistant’s developer.
- Each issue lists the layers that relate to it. When you hover over a layer, you’ll see a
→icon. Clicking on this will take you directly to that layer on your Canvas. You can also Control-click on any layer in the list and choose Reveal to find it on the Canvas.
Sometimes, the rule an Assistant is checking against might not be helpful. Or you might be working on rough ideas and want to silence some unnecessary Assistants notifications. In these cases, you can ignore issues on specific layers — or even your whole document.
To ignore an issue for a specific layer, open the Assistants results window by clicking on , then Control-click on the layer listed under the issue you want to ignore. In the contextual menu that appears, choose Ignore.
To ignore an issue for an entire document, Control-click on the issue’s description in the results window and choose Ignore Rule for Document.
When you ignore an issue, either for a specific layer or the entire document, that result will be hidden from the list. To view that result again, click on in the top-right of the window and choose Show Ignored Issues.
When you’ve set the results window to show ignored issues, they’ll appear greyed out in the list to indicate that you’ve ignored them and they won’t be added to the count in any of the badges — either in the results window or in the toolbar.
To stop ignoring an issue, first make sure you’ve set the results window to show ignored issues, then Control-click on the issue you’ve ignored and choose Stop Ignoring from the contextual menu.
If you’ve built a plugin for Sketch before, you’ll find building an Assistant easy. If you haven’t built a plugin before, you’ll find Assistants even more accessible. Unlike plugins, they don’t require you to create a UI — we’ll handle that for you. All you have to do is write the rules for your Assistant to follow. You could even adopt some of our ready-made rules and configure them to suit your needs.
If you’re interested in building an Assistant — either for your team or for the wider design community — you can dive into our developer docs right now. If you need a little assistance, contact email@example.com and we’ll help you get started.