Official · Scenario Agent Skillv1.0.0

Turn setup guides into a quick start course that reaches first success.

New users stall before their first success, and every stalled setup costs activation. Turn your setup guides and manuals into an interactive digital-human quick start guide that walks users to first successful use and answers their questions along the way. High-risk steps always point back to qualified on-site confirmation — the course guides, it never certifies.

Use it for: product setup; getting started; quick start guide; first successful use

Public contract

Skill version
v1.0.0
Authorization
OAuth 2.1 + PKCE
Connection
Streamable HTTP

Install

One command. No private package.

The Skill is public, lightweight, and versioned in GitHub. The course engine, permissions, and commercial rules stay on PersonWise.

one command
$ npx skills add personwiseai/skills --skill personwise-product-first-success

The same Skill package works in conforming Agent Skill hosts. It connects to the same remote MCP without a host-specific workflow.

Inspect the public source at personwiseai/skills

General workflow

The complete course-creation loop.

The Skill coordinates the whole authoring job while the shared MCP exposes the authenticated operations.

  1. 01

    Create from a topic or materials

    Set the learner, outcome, source boundary, language, length, and course structure.

  2. 02

    Review every authoring stage

    Inspect outlines, visible page text, narration, and visual direction before advancing.

  3. 03

    Refine without starting over

    Update specific pages, narration, presenter choices, layout, or generated images.

  4. 04

    Resume and finish safely

    Continue durable runs, recover supported failures, and complete the ordinary course publishing workflow.

One OAuth connection for every PersonWise Skill.

PersonWise never asks you to paste an API key or access token. The Agent keeps its own PKCE state and credential store; you choose one organization and authorize the complete ordinary course workflow once.

  1. 01Install the Skill in a conforming Agent host.
  2. 02Ask it to create or work on a PersonWise course. The Agent discovers the protected MCP endpoint and opens PersonWise authorization.
  3. 03Sign in to PersonWise, review the exact access request, and approve. The Agent resumes automatically.

OAuth-protected MCP endpoint

https://mcp.personwise.ai/mcp

OAuth must begin inside the Agent so the authorization returns to that same client. Never paste an authorization code or token into chat.

Shared execution

Many Skills. One MCP throughout.

Each scenario Skill narrows the workflow for a specific job. They all share this endpoint, authorization model, and course capability contract.