onboard

A guide for designing onboarding, empty states, and first-time user experiences. Onboarding is the process of helping new users understand a product and complete their first useful task.

In plain words
What is it for?
Use it to plan or improve welcome flows, first-project or first-invite steps, empty screens, explanations, and ways to measure whether onboarding worked.
Why use it?
It helps find where new users become confused or stop, then focuses the experience on reaching the product’s first meaningful result quickly.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/guillermoscript/lms-front/onboard
Any agent
npx skills add guillermoscript/lms-front --skill onboard
Clone the repo
git clone --depth 1 https://github.com/guillermoscript/lms-front

Made for: Claude Code, Codex.

Per session 28 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,742 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00028 $0.01742
Opus 5 $0.00014 $0.00871
Sonnet 5 $0.00006 $0.00348
Haiku 4.5 $0.00003 $0.00174

Measured 3d ago against content hash d3590b654e53, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

onboard scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to onboard — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/skills/onboard/SKILL.md · 242 lines

How it starts

The opening of the file, as written. The whole thing — 242 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Create or improve onboarding experiences that help users understand, adopt, and succeed with the product quickly.

Assess Onboarding Needs

Understand what users need to learn and why:

  1. Identify the challenge:

    • What are users trying to accomplish?
    • What's confusing or unclear about current experience?
    • Where do users get stuck or drop off?
    • What's the "aha moment" we want users to reach?
  2. Understand the users:

    • What's their experience level? (Beginners, power users, mixed?)
    • What's their motivation? (Excited and exploring? Required by work?)
    • What's their time commitment? (5 minutes? 30 minutes?)
    • What alternatives do they know? (Coming from competitor? New to category?)
  3. Define success:

    • What's the minimum users need to learn to be successful?
    • What's the key action we want them to take? (First project? First invite?)
    • How do we know onboarding worked? (Completion rate? Time to value?)

CRITICAL: Onboarding should get users to value as quickly as possible, not teach everything possible.

Onboarding Principles

Follow these core principles:

Show, Don't Tell

  • Demonstrate with working examples, not just descriptions
  • Provide real functionality in onboarding, not separate tutorial mode
  • Use progressive disclosure - teach one thing at a time

Make It Optional (When Possible)

  • Let experienced users skip onboarding
  • Don't block access to product
  • Provide "Skip" or "I'll explore on my own" options

Time to Value

  • Get users to their "aha moment" ASAP
  • Front-load most important concepts
  • Teach 20% that delivers 80% of value
  • Save advanced features for contextual discovery

Context Over Ceremony

  • Teach features when users need them, not upfront
  • Empty states are onboarding opportunities
  • Tooltips and hints at point of use

Respect User Intelligence

  • Don't patronize or over-explain
  • Be concise and clear
  • Assume users can figure out standard patterns

Design Onboarding Experiences

Read the full file on GitHub · 242 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 242 lines · 28 tokens per session scan A d3590b654e53

Subscribe to this mod's changes

onboard is a skill published in the GitHub repository guillermoscript/lms-front (24 stars, last pushed 3d ago), licensed MIT. It adds 28 tokens to every session and 1,742 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to onboard, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

api-development

FastGPT API 开发规范。重点强调使用 zod schema 定义入参和出参,在 API 文档中声明路由信息,编写对应的 OpenAPI 文档,以及在 API 路由中使用 schema.parse 进行验证。.

labring/FastGPT · 57 tokens

ci-workflow-sync

FastGPT CI workflow 双轨同步。当用户修改或新增 .github/workflows/ 下的 GitHub Actions workflow 时必须触发:同步更新 .forgejo/workflows/ 对应文件保持功能一致,或判断是否需要新建 Forgejo 版本。涉及 CI、GitHub Actions、Forgejo Actions、镜像构建、container registry、artifact、workflow yaml 改动、build- workflow、test- workflow 时也使用此技能。即使用户只提到"改一下 CI"或"加个 workflow"也应触发。.

labring/FastGPT · 121 tokens

prompt-optimize

Expert prompt engineering skill that transforms Claude into "Alpha-Prompt" - a master prompt engineer who collaboratively crafts high-quality prompts through flexible dialogue. Activates when user asks to "optimize prompt", "improve system instruction", "enhance AI instruction", or mentions prompt engineering tasks.

labring/FastGPT · 61 tokens

deprecate-workflow-node

当用户需要弃用一个工作流节点(保留向后兼容、隐藏出模板面板)时触发该 skill。FastGPT 工作流节点的弃用流程标准化封装,覆盖模板、Dispatcher、UI 引用等所有需要改动的位置。.

labring/FastGPT · 65 tokens

doc-i18n

将 FastGPT 文档从中文翻译为面向北美用户的英文。当用户提到翻译文档、i18n、国际化、translate docs、新增/修改了中文文档需要同步英文版时,使用此 skill。也适用于用户要求检查文档翻译缺失、批量翻译、或对比中英文文档差异的场景。.

labring/FastGPT · 89 tokens

pr-change-analysis

手动触发的 FastGPT PR 或本地分支变更梳理技能。仅当用户显式调用 $pr-change-analysis 时使用;用于 reviewer 分析一个 GitHub PR 或当前本地分支相对 upstream/main 的需求变更、影响范围、代码质量与代码风格,不用于自动审查触发。.

labring/FastGPT · 77 tokens