Skip to content
shuffl
Get started

Searches the public product guides only. Nothing from a workspace is read, and questions are not saved.

How-to guide

Review and publish knowledge

Turn a policy into a published source with an audience and dates, so Mello can answer from it and cite it.

For HR administrators and Knowledge verifiers

Have your agent do thisPaste the prompt into Claude Code, Cursor or another agent. It follows this guide over MCP and asks before it changes anything others will see.Show the prompt
Help me with "Review and publish knowledge" in my Shuffl workspace.

1. Read the guide: https://shuffl.ai/docs/markdown/knowledge
2. Add Shuffl's MCP server: https://shuffl.ai/api/mcp
   Claude Code: claude mcp add --transport http shuffl https://shuffl.ai/api/mcp
   When the browser opens, choose my workspace and allow the access the guide needs.
3. Work through the steps in order: Add a source; Start with a draft; Publish deliberately; Ask people to confirm they’ve read it; Download the handbook. Do what you can over MCP and tell me which steps only I can do in the browser or in Slack.

Show me what you will change and who it affects, and wait for my yes before publishing, inviting or sending anything.
On this page

App links open your signed-in workspace. Check the selected workspace before making changes.

Add a source

  1. Choose Add source → Write an article to write in the editor, with Markdown and a preview. Write with Mello drafts a page from its title and a short request.
  2. Choose Start from a template for one of over twenty policies, such as paid time off, expenses or code of conduct.
  3. Shuffl fills in what it knows, like your company name and HR contact, and lists it under Filled in from Shuffl. Replace every other [bracketed placeholder] before publishing.
  4. Or choose Draft with Mello on the template.
  5. Mello reads your Knowledge and official sources for where your people work, then fills every blank, marking each value Your company, The law or Typical, check.
  6. Check each one; Undo draft puts the template back. Mello is not a lawyer.
  7. Check before you publish in the editor lists rules that often differ in the US, the UK and the EU.
  8. It is not legal advice; have someone qualified review the policy.
  9. Choose Import a file for a PDF, Word, PowerPoint, Markdown, HTML or text file up to 50 MB and 500 pages.
  10. A long handbook is split by its headings into one draft per section. Password-protected PDFs cannot be read.
  11. Choose Add a website page to import a page that Shuffl re-reads when it changes, including intranet pages behind a sign-in.
  12. Connected providers such as Google Drive and Notion have their own guide.
  13. Or tell Mello in Chat what employees should know. It drafts the wording and puts it in the Inbox for a reviewer to verify.

Everything Mello answers from starts as a source in Knowledge, with a title, a body, an audience and two dates. People who manage Knowledge add, edit and publish sources on the same page everyone reads.

The Knowledge library: a search field, a Show filter and an Add source button above a table of sources with their status, audience and review date. The employee handbook is published; two other sources are drafts.
Drafts and published sources sit in one list. Employees only see what is published to them.
The Add source menu open over the Knowledge library. It lists Write an article, Start from a template, Import a file, Add a website page and one entry per connectable provider such as Google Drive, Notion and Confluence.
Add source lists every way in, including providers your workspace has not connected yet.
The Paid time off template open in the editor with a Filled in from Shuffl panel above the text, listing the policy owner and contact People Operations, how to ask through an HR request in Shuffl and the countries the policy applies in, with a Put the blanks back button.
A template arrives with what Shuffl already knows filled in, listed so you can check it.
The Paid time off template after Draft with Mello. A Drafted by Mello panel lists each value Mello chose, such as 25 paid days off a year marked The law with a gov.uk link, days you can carry over and notice to book time off marked Typical, check, and the HR contact marked Your company, followed by the sources Mello read and an Undo draft button.
Draft with Mello fills every blank and says where each value came from: your company, the law or custom.

Start with a draft

  1. Give the source a title and check its text. For an imported file, read the extracted text of each draft before you publish.
  2. Choose Who can read this after publishing?: HR admins only, Everyone in this workspace, or Selected departments, groups or roles.
  3. A blank article starts with HR admins only; templates for employees start with Everyone in this workspace.
  4. Set Effective date and Review by, in UTC. On the Review by date the source stops being used in answers until someone reviews it.
  5. Choose Save draft. Only reviewers and administrators see drafts.

Publish deliberately

  1. Open the source and choose Review and publish. Check who can read it: if only HR admins can, Mello won’t answer employees from it.
  2. Confirm with Publish source. Version history keeps every published version.
  3. Employees can use the source once the audience includes them and today falls between its effective and review dates.
  4. To change who can read a published source, choose Who can see this? in its header. Narrowing the audience removes access at once.
  5. Ask Mello a question the source answers and follow the citation. Reviewers see more than employees do, so check with an employee account.
The Publish this source? dialog over a draft called Taking time off. It lists the title, who can read it, the effective and review dates, a line saying what that audience means for employees and Mello with Change who can read it, a note to confirm the text is approved, and Cancel and Publish source buttons.
Review and publish summarises what employees will be able to rely on before Publish source confirms it.

Ask people to confirm they’ve read it

  1. Open a published source and choose Ask to confirm. Everyone in its audience is asked. Leave Message them now on to message each person in Slack or by email.
  2. People see the page under Please confirm on Home and choose I’ve read this at the end.
  3. Only the person can confirm, in the app, never an API key or agent.
  4. Confirmations lists who has and hasn’t confirmed. Remind messages the people who haven’t, at most once a day.
  5. After you publish a new version, earlier confirmations stay on the record. Ask again asks everyone to confirm the new one; Stop asking ends the request.

For a policy people must read, such as a code of conduct, ask everyone who can read it to confirm they have. Shuffl records who confirmed which version and when.

To ask only new hires, add a Read and confirm step to a playbook instead. See Read and confirm a page in Playbooks and onboarding.

A published Employee handbook in Knowledge with a Confirmations panel above the text: an Asked today chip, 21% Confirmed · 3/14 with a progress bar, a Remind button, and a list of people with the date each confirmed or Not yet.
Confirmations shows who has read and confirmed the published version, and who hasn’t yet.
The Employee handbook as an employee reads it, ending with a Confirm you’ve read this panel, an Asked by HR chip and an I’ve read this button.
An employee who is asked confirms at the end of the page, in one click.

Download the handbook

  1. In Knowledge, choose Handbook. It shows the contents, then each page published to everyone with its effective date and version number.
  2. Choose Save as PDF, then Save as PDF in the print dialog, or Markdown for a text file.
  3. Pages for particular groups or only admins are left out, and the page says how many. Drafts never appear.

When someone needs the handbook as a document, for paperwork, an auditor or print, download everything you publish as one handbook.

The Handbook page in Knowledge: the workspace logo and name above Employee handbook, a contents list of the policies published to everyone with their version numbers, and Markdown and Save as PDF buttons in the header.
The handbook gathers every page published to everyone, with contents and each policy’s effective date and version.

Verify what Mello proposes

Mello proposes knowledge when an administrator tells it what employees should know, when an HR reply has something reusable, or when it imports a file on request.

Each proposal waits in the Inbox under Reviews, and in Slack as a Knowledge draft with Approve for everyone, Admins only, Edit and Dismiss.

Choose Review, edit the title, text and audience, then Approve knowledge or Decline. Approving publishes the source.

Guidance to re-check lists sources whose review date is due or passed. Employees lose access to an overdue source until someone sets new dates.

Keep sources current

Choose Edit draft to prepare a correction, then review and publish it; employees keep the last published version meanwhile. Withdraw takes a source down at once. Archive tidies away a never-published source, and Restore brings it back.

Status tells you what to do: Needs review means the review date arrived, Scheduled means the effective date is ahead, and Changes need review means a connected document changed.

Company values deserve their own page. Praise settings can point at it, so Mello tags praise with the values people actually wrote down.

See what Knowledge is doing

Knowledge → Insights shows how many answers used verified Knowledge, which sources answer most, and Missing guidance where Mello found nothing. Answer feedback lists employees’ ratings with the sources used, and Questions to test Mello on lists questions behind Bad answer ratings. Names stay private.

What employees see

Employees open Knowledge from Home or a citation and see only published sources whose audience includes them. They can search titles, choose Look inside sources to search the text, and Ask in Chat to turn a search into a question.

The Knowledge library as an employee sees it: a list of published policies and guides with a search field that filters titles and a Look inside sources option that searches full text.
Employees get a reading view of what is published to them, with search and a shortcut to ask Mello.

Public guides and workspace knowledge are separate

These guides explain Shuffl and contain none of your company’s policies. Add private documents only in your signed-in workspace, with the right audience.

Ask the guides, the question box on these pages, searches only these public guides and does not save your question. For answers from your company’s sources, use Chat in your workspace.

Was this guide helpful?