Use when a PM needs to turn an AI capability into a bounded first-use journey, meaningful value oracle, activation hypothesis, instrumentation contract, and safe learning decision.
An AI capability is not activated because a user saw a welcome screen, sent a
prompt, or received a response. This skill helps a PM define the smallest
first-use path that reaches a job-relevant value moment, then decide what to
measure and what evidence is still missing.
When to use
Use this skill when a team is launching or materially changing:
an AI assistant, agent, copilot, chat-native app, or AI workflow;
a first-run, connect, context-setup, sample-data, or capability-discovery
experience;
an activation, onboarding, repeat-use, retention, or feature-adoption
question for an AI product;
an AI feature that may appear in a host with different tools, UI, data, or
permission capabilities.
Do not use it as a generic signup checklist or a replacement for these
adjacent routes:
pm-ai-task-boundary for who owns a task and how much autonomy is allowed;
pm-ai-data-to-purpose for the lifecycle, purpose, retention, or deletion
of data;
pm-ai-output-to-interface for choosing text, structured data, UI, or an
action proposal;
pm-ai-uncertainty-to-experience for incomplete, conflicting, delayed, or
unsupported result states;
pm-experiment-to-readout after a real experiment result exists.
Keep the output provider-neutral. A product may use an API, an MCP server, an
Apps SDK, a local model, or no live model in the first test. Name the actual
provider or host only when the input supplies current evidence.
Workflow
1. Frame the job before the funnel
Write down:
target user, job, trigger surface, and current workaround;
what the AI capability can and cannot do in this release;
the smallest consequence a user should be able to reach;
eligibility conditions, required context, data/permission boundary, and
what the user may skip or do manually;
the external state the product must never change during first use.
If the request only says “improve onboarding” or “increase activation,” stop
and mark the user job, value oracle, and evidence as Not provided. Do not
invent an Aha moment.
2. Define first value as an observable job result
Separate the stages below. A stage may be a prerequisite, but it is not proof
of value by itself.
Stage
Meaning
What it must not be mistaken for
Eligible
The user and surface may use the capability
acquisition or intent
Exposed
The user actually reached the capability
assignment or consent
Context ready
Required context was supplied or safely skipped
a useful answer
First value
The user can verify, accept, edit, or act on a job-relevant result
a response existing
Repeat value
The same or a related job succeeds again in a declared window
retention or PMF
Activated
A product-specific hypothesis combines meaningful value signals
a universal benchmark
Define a first-value oracle that another person could observe without guessing.
It should name the user action, the job artifact or decision changed, the
minimum evidence attached, and the safe exit if the result is not useful. If
the first value cannot be observed, the decision is Need evidence.
Create two to five activation candidates only when the product has enough
instrumentation to compare them. A candidate may be one completed event or a
small sequence within a natural window. Do not choose a candidate because it
is easy to count. Test whether it relates to meaningful repeat value or a
declared downstream outcome, while keeping correlation separate from causation.
3. Map the first-use path and its recovery states
Use this order, then remove steps that do not help the job:
Discover: what the user sees, asks, or receives as a relevant entry
point; what the capability is for in one plain sentence.
Confirm fit: who is eligible, what is unavailable, and what the user
can do without connecting a provider or granting a permission.
Prepare context: the minimum input, source, or preference needed; show
purpose and data scope before collection or connector use.
Reach first value: the job artifact, decision, or changed state that
proves value; let the user inspect and correct it.
Recover or leave: preserve work through missing context, delay, error,
host mismatch, permission refusal, duplicate retry, and manual fallback.
Repeat or stop: state what a second meaningful use would be and allow
the user to stop without being trapped in setup.
For every step, record the user-visible message, control, preserved work,
receipt or event, and release consequence. Loading copy must describe a real
state such as “Checking the selected source” rather than pretend that the AI
is thinking.
4. Build an instrumentation and guardrail contract
Start from the learning question, not from the analytics tool. At minimum,
define:
eligibility and exposure, including the unit and source surface;
context_ready, with completion semantics and any safe sample route;
first_value_completed, with the observable job oracle;
correction, manual_route, skip, error, timeout, and retry;
one or more repeat-value candidates with a declared window;
guardrails for trust/comprehension, privacy/permission, quality, cost,
latency, support burden, and external side effects where relevant.
For each event specify event_name, user_or_group_id, timestamp, product
version or variant, source surface, locale/device/plan when needed, privacy
classification, and the completion boundary. Prefer an event when the job
actually completes over an event when a button is clicked. If client events
can be blocked or duplicated, record the gap and use a server or receipt
source only when the product can do so lawfully and safely.
Keep exposure separate from assignment, and do not include raw prompts,
customer text, secrets, tokens, private URLs, or unnecessary context in
analytics properties. If the denominator, identity, or event semantics are
unclear, the measurement decision is Hold or Need evidence.
5. Test the normal, friction, and mismatch routes
Before asking for a broad rollout, run the smallest proportionate test:
Normal: an eligible user reaches first value with the minimum context.
Friction: the user skips, supplies partial context, corrects a result,
waits, or returns later; work and meaning remain recoverable.
Mismatch: the host/provider lacks a capability, a permission is refused,
the result is unsupported, or instrumentation fires at the wrong boundary;
the manual or text route remains usable.
Use a prototype, concierge run, beta cohort, staged flag, or experiment based
on risk and traffic. Low traffic is not a reason to manufacture a percentage.
Agent or synthetic runs can expose missing states, but they are hypothesis
inputs, not real-user activation, retention, comprehension, or PMF evidence.
6. Set rollout, decision, and writeback rules
State the smallest audience, observation window, owner, kill switch, rollback
route, and review date. Choose one decision:
Ship / scale: first-value oracle is valid, instrumentation is trustworthy,
UX checks pass, and guardrails are within bounds;
Pilot: the contract is ready for a bounded non-owner test, but live
behavior or adoption is not established;
Iterate: the mechanism is plausible but a named friction or missing state
blocks stronger evidence;
Hold: the denominator, eligibility, data/permission boundary, or evidence
is not trustworthy;
Rollback: trust, privacy, safety, core job success, cost, or external
state is harmed;
Need evidence: a claim depends on a live provider, host, user, or product
outcome that has not been observed.
Write the learning question, evidence, interpretation, and next action back
to the product decision log, analytics plan, QA regression list, or evaluation
set. Do not write owner-run clone counts or a GitHub star count as product
activation evidence.
Output contract
Return a First-Use to Activation Contract with these sections. Use
Not provided, Not run, or Need evidence instead of filling gaps with
plausible detail.
Decision and evidence boundary
decision and decision owner;
target user, job, trigger, workaround, and desired outcome;
capability boundary, provider/host if evidenced, and out of scope;
current evidence, confidence, and unverified claims.
First-use contract
Stage
User job and copy
Required input/data/permission
User control and fallback
Evidence
Discover
Confirm fit
Prepare context
First value
Recover / leave
Repeat value
Activation hypothesis
first-value oracle: observable action, artifact/decision, source or receipt,
and safe exit;
candidate events and natural window;
eligibility, exposure, assignment, identity/group unit, and denominator;
why this is a value hypothesis rather than a setup metric;
evidence needed to relate it to repeat value or a downstream outcome;
what would disconfirm it.
Instrumentation and guardrails
Event or guardrail
Trigger/completion boundary
Properties and privacy class
Source/owner
QA and status
Eligibility
Exposure
First value
Correction / manual route
Error / timeout / retry
Repeat value
Trust / privacy / quality / cost guardrail
States and behavior evidence
Cover first-time, empty, loading, partial, permission/data disclosure,
unsupported provider or host, error, timeout, retry, skip/later, mobile,
accessibility, and manual fallback. For each state include:
user-visible message with no invented capability;
control and consequence;
preserved work, receipt, or reconciliation path;
normal, friction, and mismatch test oracle;
Not run status until directly observed.
Rollout and decision rule
Include audience/cohort, test type, exposure window, owner, review date,
feature flag or kill switch if available, rollback/reconciliation path,
primary value measure, guardrails, and these conditions:
Ship / scale if:
Pilot if:
Iterate if:
Hold if:
Rollback if:
Need evidence if:
Learning writeback
Record what changed, what was learned, what remains unknown, the next smallest
test, and the exact destination for the writeback. Separate a public artifact
release from product adoption, retention, safety, and star evidence.
Edge cases
Setup completed, no value: keep setup as a prerequisite event; do not
count activation until the first-value oracle passes.
Model response exists but is not usable: record response_received as a
diagnostic only; require user verification, correction, or a manual route.
First value is wrong or unsupported: preserve input, show the limitation,
capture the correction/manual path, and hold any quality claim.
Permission or connector refused: explain what cannot happen, do not
silently use another source, and leave a safe no-connector route.
Host/provider mismatch: progressive enhancement may add a richer UI, but
the core job must have a labelled text or manual fallback where possible.
Duplicate retry or unknown outcome: reconcile the receipt before a
second request; never use a retry as evidence of a second value.
Multiple activation candidates: compare candidates against a declared
meaningful repeat or outcome signal; do not pick the highest rate after
looking at results without recording the selection rule.
Low traffic or sparse data: prefer direct task observation, a small beta,
and qualitative notes. Leave the denominator and confidence visible.
Segment disagreement: inspect device, locale, plan, user role, source,
and host slices before averaging away a harmful experience.
Privacy-sensitive analytics: minimize properties, classify them, redact
before export, and keep raw content out of event payloads.
External side effect appears in the first-use request: route to
pm-ai-approval-to-flow and pm-ai-identity-to-boundary; this skill does
not authorize sending, publishing, assigning, deleting, or changing an
account.
Final check
Before returning the contract, verify:
The user job and first-value oracle are observable, not a slogan.
Eligible, exposed, context-ready, first-value, repeat-value, and
activated are separate states.
Setup completion, response existence, and user outcome are not merged.
Event names, completion boundaries, denominators, identity, privacy,
QA method, and evidence status are explicit.
First-time, empty, loading, partial, permission, mismatch, error,
recovery, skip/later, mobile, accessibility, and trust states are covered.
Normal, friction, and mismatch routes preserve work and a safe exit.
A prototype, beta, flag, experiment, or qualitative test is chosen for
the actual risk and traffic; no universal benchmark is invented.
Primary value measure, guardrails, decision rule, kill switch, rollback,
and writeback location are named.
Provider/host compatibility and any external side effect are either
evidenced or marked Need evidence.
The final decision is Ship / scale, Pilot, Iterate, Hold,
Rollback, or Need evidence, with the reason attached.
1---2name: pm-ai-first-use-to-activation3description: Use when a PM needs to turn an AI capability into a bounded first-use journey, meaningful value oracle, activation hypothesis, instrumentation contract, and safe learning decision.4---56# PM AI First Use to Activation78An AI capability is not activated because a user saw a welcome screen, sent a9prompt, or received a response. This skill helps a PM define the smallest10first-use path that reaches a job-relevant value moment, then decide what to11measure and what evidence is still missing.1213## When to use1415Use this skill when a team is launching or materially changing:1617- an AI assistant, agent, copilot, chat-native app, or AI workflow;18- a first-run, connect, context-setup, sample-data, or capability-discovery19 experience;20- an activation, onboarding, repeat-use, retention, or feature-adoption21 question for an AI product;22- an AI feature that may appear in a host with different tools, UI, data, or23 permission capabilities.2425Do not use it as a generic signup checklist or a replacement for these26adjacent routes:2728- `pm-ai-task-boundary` for who owns a task and how much autonomy is allowed;29- `pm-ai-data-to-purpose` for the lifecycle, purpose, retention, or deletion30 of data;31- `pm-ai-output-to-interface` for choosing text, structured data, UI, or an32 action proposal;33- `pm-ai-uncertainty-to-experience` for incomplete, conflicting, delayed, or34 unsupported result states;35- `pm-experiment-to-readout` after a real experiment result exists.3637Keep the output provider-neutral. A product may use an API, an MCP server, an38Apps SDK, a local model, or no live model in the first test. Name the actual39provider or host only when the input supplies current evidence.4041## Workflow4243### 1. Frame the job before the funnel4445Write down:4647- target user, job, trigger surface, and current workaround;48- what the AI capability can and cannot do in this release;49- the smallest consequence a user should be able to reach;50- eligibility conditions, required context, data/permission boundary, and51 what the user may skip or do manually;52- the external state the product must never change during first use.5354If the request only says “improve onboarding” or “increase activation,” stop55and mark the user job, value oracle, and evidence as `Not provided`. Do not56invent an Aha moment.5758### 2. Define first value as an observable job result5960Separate the stages below. A stage may be a prerequisite, but it is not proof61of value by itself.6263| Stage | Meaning | What it must not be mistaken for |64| --- | --- | --- |65| Eligible | The user and surface may use the capability | acquisition or intent |66| Exposed | The user actually reached the capability | assignment or consent |67| Context ready | Required context was supplied or safely skipped | a useful answer |68| First value | The user can verify, accept, edit, or act on a job-relevant result | a response existing |69| Repeat value | The same or a related job succeeds again in a declared window | retention or PMF |70| Activated | A product-specific hypothesis combines meaningful value signals | a universal benchmark |7172Define a first-value oracle that another person could observe without guessing.73It should name the user action, the job artifact or decision changed, the74minimum evidence attached, and the safe exit if the result is not useful. If75the first value cannot be observed, the decision is `Need evidence`.7677Create two to five activation candidates only when the product has enough78instrumentation to compare them. A candidate may be one completed event or a79small sequence within a natural window. Do not choose a candidate because it80is easy to count. Test whether it relates to meaningful repeat value or a81declared downstream outcome, while keeping correlation separate from causation.8283### 3. Map the first-use path and its recovery states8485Use this order, then remove steps that do not help the job:86871. **Discover:** what the user sees, asks, or receives as a relevant entry88 point; what the capability is for in one plain sentence.892. **Confirm fit:** who is eligible, what is unavailable, and what the user90 can do without connecting a provider or granting a permission.913. **Prepare context:** the minimum input, source, or preference needed; show92 purpose and data scope before collection or connector use.934. **Reach first value:** the job artifact, decision, or changed state that94 proves value; let the user inspect and correct it.955. **Recover or leave:** preserve work through missing context, delay, error,96 host mismatch, permission refusal, duplicate retry, and manual fallback.976. **Repeat or stop:** state what a second meaningful use would be and allow98 the user to stop without being trapped in setup.99100For every step, record the user-visible message, control, preserved work,101receipt or event, and release consequence. Loading copy must describe a real102state such as “Checking the selected source” rather than pretend that the AI103is thinking.104105### 4. Build an instrumentation and guardrail contract106107Start from the learning question, not from the analytics tool. At minimum,108define:109110- `eligibility` and `exposure`, including the unit and source surface;111- `context_ready`, with completion semantics and any safe sample route;112- `first_value_completed`, with the observable job oracle;113- `correction`, `manual_route`, `skip`, `error`, `timeout`, and `retry`;114- one or more repeat-value candidates with a declared window;115- guardrails for trust/comprehension, privacy/permission, quality, cost,116 latency, support burden, and external side effects where relevant.117118For each event specify `event_name`, `user_or_group_id`, timestamp, product119version or variant, source surface, locale/device/plan when needed, privacy120classification, and the completion boundary. Prefer an event when the job121actually completes over an event when a button is clicked. If client events122can be blocked or duplicated, record the gap and use a server or receipt123source only when the product can do so lawfully and safely.124125Keep exposure separate from assignment, and do not include raw prompts,126customer text, secrets, tokens, private URLs, or unnecessary context in127analytics properties. If the denominator, identity, or event semantics are128unclear, the measurement decision is `Hold` or `Need evidence`.129130### 5. Test the normal, friction, and mismatch routes131132Before asking for a broad rollout, run the smallest proportionate test:133134- **Normal:** an eligible user reaches first value with the minimum context.135- **Friction:** the user skips, supplies partial context, corrects a result,136 waits, or returns later; work and meaning remain recoverable.137- **Mismatch:** the host/provider lacks a capability, a permission is refused,138 the result is unsupported, or instrumentation fires at the wrong boundary;139 the manual or text route remains usable.140141Use a prototype, concierge run, beta cohort, staged flag, or experiment based142on risk and traffic. Low traffic is not a reason to manufacture a percentage.143Agent or synthetic runs can expose missing states, but they are hypothesis144inputs, not real-user activation, retention, comprehension, or PMF evidence.145146### 6. Set rollout, decision, and writeback rules147148State the smallest audience, observation window, owner, kill switch, rollback149route, and review date. Choose one decision:150151- `Ship / scale`: first-value oracle is valid, instrumentation is trustworthy,152 UX checks pass, and guardrails are within bounds;153- `Pilot`: the contract is ready for a bounded non-owner test, but live154 behavior or adoption is not established;155- `Iterate`: the mechanism is plausible but a named friction or missing state156 blocks stronger evidence;157- `Hold`: the denominator, eligibility, data/permission boundary, or evidence158 is not trustworthy;159- `Rollback`: trust, privacy, safety, core job success, cost, or external160 state is harmed;161- `Need evidence`: a claim depends on a live provider, host, user, or product162 outcome that has not been observed.163164Write the learning question, evidence, interpretation, and next action back165to the product decision log, analytics plan, QA regression list, or evaluation166set. Do not write owner-run clone counts or a GitHub star count as product167activation evidence.168169## Output contract170171Return a `First-Use to Activation Contract` with these sections. Use172`Not provided`, `Not run`, or `Need evidence` instead of filling gaps with173plausible detail.174175### Decision and evidence boundary176177- decision and decision owner;178- target user, job, trigger, workaround, and desired outcome;179- capability boundary, provider/host if evidenced, and out of scope;180- current evidence, confidence, and unverified claims.181182### First-use contract183184| Stage | User job and copy | Required input/data/permission | User control and fallback | Evidence |185| --- | --- | --- | --- | --- |186| Discover | | | | |187| Confirm fit | | | | |188| Prepare context | | | | |189| First value | | | | |190| Recover / leave | | | | |191| Repeat value | | | | |192193### Activation hypothesis194195- first-value oracle: observable action, artifact/decision, source or receipt,196 and safe exit;197- candidate events and natural window;198- eligibility, exposure, assignment, identity/group unit, and denominator;199- why this is a value hypothesis rather than a setup metric;200- evidence needed to relate it to repeat value or a downstream outcome;201- what would disconfirm it.202203### Instrumentation and guardrails204205| Event or guardrail | Trigger/completion boundary | Properties and privacy class | Source/owner | QA and status |206| --- | --- | --- | --- | --- |207| Eligibility | | | | |208| Exposure | | | | |209| First value | | | | |210| Correction / manual route | | | | |211| Error / timeout / retry | | | | |212| Repeat value | | | | |213| Trust / privacy / quality / cost guardrail | | | | |214215### States and behavior evidence216217Cover first-time, empty, loading, partial, permission/data disclosure,218unsupported provider or host, error, timeout, retry, skip/later, mobile,219accessibility, and manual fallback. For each state include:220221- user-visible message with no invented capability;222- control and consequence;223- preserved work, receipt, or reconciliation path;224- normal, friction, and mismatch test oracle;225- `Not run` status until directly observed.226227### Rollout and decision rule228229Include audience/cohort, test type, exposure window, owner, review date,230feature flag or kill switch if available, rollback/reconciliation path,231primary value measure, guardrails, and these conditions:232233```text234Ship / scale if:235Pilot if:236Iterate if:237Hold if:238Rollback if:239Need evidence if:240```241242### Learning writeback243244Record what changed, what was learned, what remains unknown, the next smallest245test, and the exact destination for the writeback. Separate a public artifact246release from product adoption, retention, safety, and star evidence.247248## Edge cases249250- **Setup completed, no value:** keep setup as a prerequisite event; do not251 count activation until the first-value oracle passes.252- **Model response exists but is not usable:** record `response_received` as a253 diagnostic only; require user verification, correction, or a manual route.254- **First value is wrong or unsupported:** preserve input, show the limitation,255 capture the correction/manual path, and hold any quality claim.256- **Permission or connector refused:** explain what cannot happen, do not257 silently use another source, and leave a safe no-connector route.258- **Host/provider mismatch:** progressive enhancement may add a richer UI, but259 the core job must have a labelled text or manual fallback where possible.260- **Duplicate retry or unknown outcome:** reconcile the receipt before a261 second request; never use a retry as evidence of a second value.262- **Multiple activation candidates:** compare candidates against a declared263 meaningful repeat or outcome signal; do not pick the highest rate after264 looking at results without recording the selection rule.265- **Low traffic or sparse data:** prefer direct task observation, a small beta,266 and qualitative notes. Leave the denominator and confidence visible.267- **Segment disagreement:** inspect device, locale, plan, user role, source,268 and host slices before averaging away a harmful experience.269- **Privacy-sensitive analytics:** minimize properties, classify them, redact270 before export, and keep raw content out of event payloads.271- **External side effect appears in the first-use request:** route to272 `pm-ai-approval-to-flow` and `pm-ai-identity-to-boundary`; this skill does273 not authorize sending, publishing, assigning, deleting, or changing an274 account.275276## Final check277278Before returning the contract, verify:279280- [ ] The user job and first-value oracle are observable, not a slogan.281- [ ] Eligible, exposed, context-ready, first-value, repeat-value, and282 activated are separate states.283- [ ] Setup completion, response existence, and user outcome are not merged.284- [ ] Event names, completion boundaries, denominators, identity, privacy,285 QA method, and evidence status are explicit.286- [ ] First-time, empty, loading, partial, permission, mismatch, error,287 recovery, skip/later, mobile, accessibility, and trust states are covered.288- [ ] Normal, friction, and mismatch routes preserve work and a safe exit.289- [ ] A prototype, beta, flag, experiment, or qualitative test is chosen for290 the actual risk and traffic; no universal benchmark is invented.291- [ ] Primary value measure, guardrails, decision rule, kill switch, rollback,292 and writeback location are named.293- [ ] Provider/host compatibility and any external side effect are either294 evidenced or marked `Need evidence`.295- [ ] The final decision is `Ship / scale`, `Pilot`, `Iterate`, `Hold`,296 `Rollback`, or `Need evidence`, with the reason attached.
Run npx skillmds@latest add asdc163/pm-ai-first-use-to-activation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Use when a PM needs to turn an AI capability into a bounded first-use journey, meaningful value oracle, activation hypothesis, instrumentation contract, and safe learning decision. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
asdc163 (@asdc163) published this skill. Their other Agent Skills are listed on their SkillMD profile.