BeSkilled Studio guide

How to use Studio to build certifications and write microlessons. For the team testing Studio at studio.beskilled.ai.

Version of 18 November 2026. Labels in quotes are the words you see on screen.

Contents

  1. Sign in, roles and invites
  2. Find your way
  3. Frameworks
  4. Certifications
  5. Libraries: personas and scenes
  6. Content: upload documents
  7. Microlessons
  8. Preview
  9. Report a problem

1. Sign in, roles and invites

How to sign in with an email code

  1. Open studio.beskilled.ai. Studio sends you to the screen Sign in to BeSkilled.
  2. Type your email and choose Continue.
  3. Open the email from BeSkilled and type the 6-digit code in Code.
  4. Choose Sign in. Studio opens on Home.
The Sign in to BeSkilled screen with the Email field and the Continue button.
The sign-in screen (steps 1 and 2).
The Check your email screen with the Code field and the Sign in button.
The code screen (steps 3 and 4).

The code works for 15 minutes. If it expires, choose Send a new code. To change the address, choose Use a different email.

How to sign in with Google

Google sign-in works only after you link Google to your account.

  1. Sign in once with an email code.
  2. Open your name at the foot of the left sidebar and choose Your profile.
  3. Under Alternate login, choose Link Google. Studio emails you a code to confirm, then sends you on with Continue to Google.
  4. Next time, choose Continue with Google on the sign-in screen.

Roles

Each person in Studio has one role. An Owner can change what a role allows in Team, so your team can differ from this default table.

What you can doOwnerSuper AdminInstructional Designer
Add, rename and archive certifications, specialties and capabilitiesYesYesNo
Assign capabilities to peopleYesYesNo
Write a capability's brief and lesson mapYesYesIf assigned
Create and edit microlessonsYesYesYes
Review microlessons (comment, send back)YesYesYes
Approve microlessonsYesYesNo, but can mark Ready for approval
Create, edit and archive frameworks, library entries and contentYesYesYes
Delete and restore anythingYesYesNo
See the team, invite people, read the audit trailYesYesNo
Give the Owner or Super Admin role, edit permissionsYesNoNo

A reviewer is not a role. When you send a microlesson for review, you choose a person as its reviewer.

How to invite someone

  1. Open Team in the sidebar and choose Invite someone.
  2. Type the Name and Email, and choose a Role.
  3. Choose Send invitation.
The Invite someone form in Team, filled in for Tessa Morgan.
The invitation form in Team (steps 2 and 3).

The invitation lasts 7 days. The person accepts it when they sign in with that email. A person with no role sees Your account cannot open Studio yet.

2. Find your way

The dark sidebar on the left holds every page. You see only the pages your role allows.

PageWhat it is for
SearchFind any certification, capability, microlesson, entry or document. Shortcut: Ctrl+K or Cmd+K.
HomeYour work: Waiting on you, Recently opened and the progress of each certification. Choose a certification's name to open it in Certification.
CertificationEvery certification, specialty and capability, and who holds each capability.
LibrariesPersonas, scenes and the other pieces that microlessons reuse.
ContentSource documents that the AI reads.
FrameworksThe patterns that shape capabilities and microlessons.
Team, Audit trail, InsightsPeople and roles, a log of changes, and waitlist numbers. Owners and Super Admins only.

The bell above your name shows notifications, for example when someone sends you a microlesson to review. Your name at the foot opens Your profile and Sign out.

The Studio sidebar with Search and the page list.
The sidebar. Most work starts in Certification (1), Libraries (2) and Content (3).

How the parts fit together

  1. A framework sets the pattern.
  2. A certification holds specialties, and each specialty holds capabilities.
  3. A capability holds microlessons. You build them in four steps: Content and frameworks, Brief, Lesson map and Microlesson content.
  4. Libraries and Content give the AI the people, situations and source material to write from.

3. Frameworks

A framework is a pattern that you write once and use many times: its steps, its rules and, for lessons, the sections each lesson is built from.

Studio has two kinds:

The frameworks in Studio now

NameKindStepsRules
COACHCapability frameworkConnect with Intent, Observe & Diagnose, Acknowledge Strengths, Challenge, Head into Action. Its default lesson framework is FLOW.In order. Every step must be included.
FLOWLesson framework, skill lessonsFrame, Learn, Outcome, Way ForwardIn order. Every substep must be included.
CORELesson framework, conceptual lessonsClarify, Observe, Relate, ExecuteAny order. Substeps can be left out.

A FLOW lesson has 12 sections: Objective, Your First Take, Demo, one Learn section for each of the 4 steps, Make It Your Own, Practice Level 1, 2 and 3, and Completion.

How to view a framework

  1. Open Frameworks. Use the type buttons, Search by name or Lesson type to narrow the list.
  2. Choose a framework, for example FLOW. You see its purpose, steps, rules and lesson shape.
  3. Choose Preview lesson (or Preview capability) to see the structure it makes.
The Frameworks page with the search, the lesson type filter and the list of frameworks.
The Frameworks page (steps 1 and 2).
The FLOW framework page with its purpose and the Preview lesson button.
The FLOW framework page (steps 2 and 3).

How to create a framework

  1. On Frameworks, choose New framework.
  2. Choose Capability framework or Lesson framework.
  3. Fill in Name and Purpose. For a lesson framework, choose the Lesson type. You cannot change the lesson type later.
  4. Add steps with Add a step. Give each step a name and a definition. Use the arrows or drag to reorder them.
  5. For a lesson framework, choose Add a lesson shape to set its sections. The preview on the right follows your edits.
  6. Choose the create button, for example Create lesson framework.

How to edit a framework

  1. Open the framework and choose Edit.
  2. Make your changes and choose Save. Studio says Saved as version N.

Microlessons keep the framework version they were made with. The framework page lists who uses it. You can move draft microlessons to the new version from there.

To go back, choose See version history, pick a version and choose Restore this version. To retire a framework, archive it. You can undo the archive from the message that appears.

4. Certifications

A certification holds specialties, a specialty holds capabilities, and a capability holds microlessons.

Example from Studio now:

Each level has a short code that you can never change. A certification code has 2 to 8 capital letters or digits. A specialty or capability code has 2 to 6, and Studio puts the parent's code and an underscore in front of it, for example LEP_. Studio suggests a code from the name.

The two views

How to create a certification, a specialty and a capability

  1. Open Certification and choose Cards.
  2. Choose New certification. Type the Name, check the Short code, and choose Create certification.
  3. Open the certification card and choose New specialty. Fill in the dialog and choose Create specialty.
  4. Open the specialty and choose New capability. Fill in the dialog and choose Create capability.
Certification in the Cards view with the Leadership Excellence Professional card.
Certification in the Cards view (steps 1 to 3).

You can also choose New certification in Compact. Studio then shows only the new certification, in its own row with Add a specialty. Choose Show all capabilities to see everything again.

Compact narrowed to the new certification Customer Service Excellence, with its row and the Add a specialty button.
Compact after New certification: the Certification filter shows the new certification (1), and its row has Add a specialty (2).

How to assign a capability holder

One person holds the whole capability: its brief, its lesson map and, to start with, every microlesson in it.

  1. Find the capability and open its menu, Actions for <name> (the three dots).
  2. Choose Assign (or Reassign if someone holds it).
  3. Choose a person in Holder. Only people who can write microlessons are listed.
  4. Choose Assign.

How to rename, archive, restore and delete

5. Libraries: personas and scenes

A library entry is a reusable piece that you write once and any microlesson can use.

Libraries also hold skills, moods, praise and tools.

How to create a persona

  1. Open Libraries and choose New entry, then Persona.
  2. Fill in Name and the short description.
  3. Fill in Who they are (pronouns, age, role and title, industry), How they speak and respond and Guardrails.
  4. Choose Create persona.
The Libraries page with the New entry button.
The Libraries page (step 1).

How to create a scene and link a persona to it

  1. In Libraries, choose New entry, then Scene.
  2. Fill in the name and short description.
  3. Under Who and when, choose a Persona, for example Maya. Only active personas are listed. Tick the practice levels the scene is for: Level 1, Level 2, Level 3 (transfer).
  4. Fill in Setting. KPI context is required, one item per line.
  5. Fill in How it feels, Boundaries and At runtime as needed.
  6. Choose Create scene.
The What do you want to add? page with the Persona and Scene cards.
Choose Persona or Scene (step 1 of both lists).

How to edit an entry

  1. Open the entry and choose Edit.
  2. Change what you need and choose Save. Studio says Saved as version N.

The side of the entry page shows which scenes and microlessons use it. Microlessons keep the version they use until someone moves them to the newer one. See version history shows each version. Choose Archive to retire an entry, and Unarchive to bring it back.

6. Content: upload documents

A content document is a source file that the AI reads when it writes briefs and microlessons.

TypeUse it forExamples in Studio now
BriefWhat a lesson teachesWhat Coaching IS…and ISN'T, Promoting Self Discovery, Practice with Purpose
ToolSomething the learner opens or works fromMap the Skills, Mark the Focus
ReferenceBackground and past lessons to draw on

How to upload documents

  1. Open Content and choose Upload files.
  2. Drop files on the page, or choose Choose files. You can add PDF, Word, PowerPoint, Excel, CSV, Markdown or text files, up to 30 MB each and 10 at a time.
  3. Check the Title of each file and choose its Type. Set all to sets one type for every file. Tip: if a file describes the lessons, choose Brief.
  4. Choose Upload N files.
  5. Wait while each row says Processing. It changes to Ready after about 30 seconds.
The Upload files page with the Choose files button.
The upload page (step 2).
One chosen file with its title and type, and the Upload 1 file button.
A chosen file, ready to upload (steps 3 and 4).

If a file has a password, type it and choose Unlock. If a row fails, choose Try again.

How to open a document

  1. On Content, choose the document in the list.
  2. Read its text. The side boxes show the Source file, the AI reading state (Ready when the AI can use it) and which capabilities and microlessons use it.

You can also write a document in Studio with New document.

7. Microlessons

A microlesson is one short lesson inside a capability, built from sections, and each section is built from steps.

How to open a capability

  1. Open Certification.
  2. Choose the capability, for example Map the Skills, Mark the Focus. In Cards view, open the certification, then the specialty first.
  3. The capability page shows four steps across the top: Content and frameworks, Brief, Lesson map, Microlesson content. A step does not block the next one.

Step 1: content and frameworks

  1. Under Content, choose Attach from Content to pick documents, or Upload files to add new ones.
  2. Under Frameworks, choose the Capability framework, for example COACH. This also sets the Microlesson framework to its default, FLOW. You can change it, or choose None or Not applicable.
  3. Choose a route: Draft the microlessons with AI or Write them yourself.
Content and frameworks for Focus Huddles: Attach from Content and the two framework choices.
Content and frameworks for Focus Huddles (steps 1 and 2).
Today you must choose the microlesson framework first. Until you do, Draft the microlessons with AI stays off and says Choose the microlesson framework first.

Step 2: write the brief and objective

The capability brief says what the capability is for and what every microlesson must follow.

Choose Save the brief. Studio says Brief saved. The lesson map is drafted from the saved brief.

Step 3: add microlessons to the lesson map

Move microlessons up or down and choose Save order. The menu on each microlesson has Duplicate. A copy goes to Unplaced until you choose Place at the end.

Step 4: write the microlesson

On Microlesson content, choose Draft with AI on a microlesson, or open it. The microlesson page has two tabs: Lesson and Brief and links.

The Connect with Intent microlesson page with its Lesson and Brief and links tabs.
The microlesson page. Lesson (1) holds the sections and steps. Brief and links (2) holds the brief, the framework and the library entries.

How to choose the lesson framework

  1. Open the Brief and links tab.
  2. Under Framework, choose the Lesson framework, for example FLOW, or No framework. The capability's default is chosen for you when it has one.

How to edit the microlesson brief

On Brief and links, fill in What the lesson teaches, the Memory anchor (one short line the objective quotes word for word) and the Core insight. For a skill lesson, choose the Critical step. Under How it presents, keep Let the AI choose or pick another option. Studio saves as you type.

The Memory anchor and Core insight fields on Brief and links.
Brief and links: the Memory anchor (1) and the Core insight (2).

How to draft with AI

  1. Make sure a lesson framework is chosen and the brief is written. Without them, Studio asks you to Write the brief first.
  2. On the Lesson tab, choose Write the outline. The AI proposes the sections.
  3. Check the outline. Change a section title if you need to. Choose Accept outline and write sections.
  4. The AI writes the sections, 3 at a time. When it finishes, choose Read the N written sections.
  5. For each section, choose Accept, Edit then Accept, or Reject. Nothing changes in the lesson until you accept. If some sections fail, choose Try the N failed again.

To write by hand instead, use Or write it yourself to lay out empty sections, then Add a step in each.

How to use the AI assistant

  1. Open AI assistant. Type your request in Message the AI, or choose a quick ask such as Shorter or Draft this section.
  2. When the answer lists Offered changes, choose Run on the change you want. Nothing happens until you press Run.
  3. The AI shows a proposal. Choose Accept or Reject.

On an empty section, Draft with AI opens the assistant with Draft this section.

How to link a persona or scene for role-play

Role-play steps sit in the practice sections. You link the persona and scene to the microlesson, not to a single step.

  1. Open Brief and links and find Library entries.
  2. Choose Add a persona, for example Maya, and Add a scene, for example Customer Feedback Conversation (Maya).
  3. To use a different character at one practice level, set Persona for level N or Scene for level N. Same as above means the level uses the main ones.

When a newer version of an entry exists, the link says Version N available. Choose Use version N to move to it.

How to see and restore revisions

Studio saves every change as a revision. The top of the page says Saving, Saved or Not saved.

  1. Choose See version history. The list shows who saved each revision.
  2. Choose a revision, then Restore revision N, then Restore. Studio saves it as the newest revision.

If someone else saved while you were editing, Studio tells you. Choose Load revision N to get their version.

How to send for review, comment, return and approve

  1. The author fixes every gap that the review box lists. Then the author chooses Send for review, picks the Reviewer and chooses Send to <name>. The microlesson is locked while in review.
  2. The reviewer opens it from Waiting on you on Home or from the bell. The reviewer uses Comment on <field> on any part, types a note and chooses Comment.
  3. The reviewer chooses Send back to return it, or Approve. An Instructional Designer who cannot approve chooses Ready for approval, and an Owner or Super Admin approves.
  4. When the microlesson comes back, the author answers each comment with Reply or Resolve, makes the changes and chooses Send again.
  5. An approved microlesson is Locked: approved. Choose Reopen to edit it again. It goes back to draft.

To give a microlesson to another author, choose More actions, then Hand to someone.

Stages and their colours

StageColourMeaning
Not startedGrey outlineNothing written yet.
Being writtenBlueThe AI is writing it.
DraftLavenderWritten, not yet sent for review.
In reviewAmberWith a reviewer.
ReturnedMagentaThe reviewer sent it back with comments.
ApprovedDark greenApproved and locked.
PublishedGreenLive for learners.

How to archive a microlesson

  1. Choose More actions, then Archive.
  2. Confirm. The page then says This microlesson is archived.

Worked example: a FLOW lesson with a Maya role-play

  1. Open Certification, then LEP, then Professional Communication Essentials, then Map the Skills, Mark the Focus.
  2. On Content and frameworks, choose Attach from Content and pick the tool Map the Skills, Mark the Focus and the brief Practice with Purpose. Choose Attach.
  3. Set the Microlesson framework to FLOW.
  4. On Brief, write the Objective, for example: Map a team member's skills and mark the one to focus on next. Choose Save the brief.
  5. On Lesson map, choose Add a microlesson. Title: Mark the Focus. What it teaches: choose the one skill that will make the biggest difference. Choose Add to the map.
  6. Open the microlesson. On Brief and links, check that the lesson framework is FLOW. Fill in the Memory anchor, for example: One skill, one focus. Fill in the Core insight and choose the Critical step.
  7. Under Library entries, choose Add a persona, then Maya. Choose Add a scene, then Customer Feedback Conversation (Maya).
  8. On Lesson, choose Write the outline. Check the 12 FLOW sections and choose Accept outline and write sections.
  9. Read each section and accept, edit or reject it. Open Practice Level 1 and check that the role-play steps use Maya.
  10. When the review box lists no gaps, choose Send for review and pick a reviewer.

8. Preview

Preview is a voice session with SAMI on the saved microlesson. You talk the lesson through with SAMI, as a learner will, before learners do.

How to preview a microlesson

  1. Open the microlesson and choose Preview. It shows once the lesson has steps, and not while you look at version history.
  2. Choose Start talking.
  3. When your browser asks, allow the microphone.
  4. Talk. SAMI leads you through the lesson step by step, and you answer as a learner would.
  5. Choose End to stop. The transcript stays on screen. Choose Start again for a new session, or Close preview to go back to the lesson.
The top of the Connect with Intent microlesson page with the Preview button.
The Preview button on the microlesson page (step 1).
The preview screen with the orb, Talk this lesson through with SAMI, and the Start talking button.
The preview before you start (step 2).

Preview uses the last saved revision. The top of the screen names it, for example Revision 12, as a learner hears it. Close preview or the Esc key also ends a session.

What you see during a session

If the session does not start

Studio saysWhat to do
Your microphone is blockedAllow the microphone for this site in your browser's site settings. Most browsers open them from the icon beside the address bar. Then choose Try again.
The voice session could not startCheck your internet connection, then choose Try again. If it fails again, report it (section 9).
You've used today's 20 previews. More tomorrow.Each person can start 20 sessions in 24 hours. Each session counts for 24 hours after you start it, so try again later.
The preview screen with the message Your microphone is blocked and the Try again button.
A blocked microphone: the message (1) and Try again (2).

9. Report a problem

Send each problem to Nikhil. Include:

  1. Page: where you were, for example the microlesson code or the page name.
  2. What you clicked: the buttons, in order.
  3. What you expected to happen.
  4. What happened, with any message word for word.
  5. A screenshot of the whole screen.
The top of a microlesson page: its name, Connect with Intent, and its code, LEP_PCE_HUDL_CWI.
The microlesson name and code to give as the page (item 1).

Example: LEP_PCE_HUDL_CWI, Preview. I chose Start talking and allowed the microphone. I expected SAMI to talk. Studio said The voice session could not start. Screenshot attached.