AgentSkillsCN

writing-onboarding-steps

为新用户设计清晰、富有激励性的入门引导内容。适用于打造首次使用体验、设置向导、功能巡礼,或构建循序渐进的用户教育流程时使用。

SKILL.md
--- frontmatter
name: writing-onboarding-steps
description: Write clear, motivating onboarding step content for new users. Use when designing first-run experiences, setup wizards, feature tours, or progressive user education flows.

Writing Onboarding Steps

Quick start

Collect or infer:

  • Onboarding type (setup wizard, feature tour, contextual tip)
  • Total number of steps
  • Goal of each step
  • User's prior knowledge level

Then produce output using TEMPLATES.md. Validate with RUBRIC.md.

Workflow

  1. Define the onboarding goal and step count
  2. For each step, identify the single action or concept
  3. Write step headline (what to do or learn)
  4. Write step body (why it matters or how to do it)
  5. Write action label (if step requires user action)
  6. Run the rubric check. Revise until it passes.

Degrees of freedom

  • Low: One concept per step is mandatory
  • Medium: Tone can be enthusiastic for welcome, focused for setup
  • Allowed variation: Body text length varies by step complexity

Constraints

  • Step headline: max 50 characters
  • Step body: max 150 characters
  • Action label: max 25 characters
  • Maximum 7 steps per wizard (recommend 3-5)
  • Each step must have exactly one focus

References