First-time User Conversation with OpenHands
Skill purpose
In <= 5 progressive questions, interview the user to identify their coding goal and constraints, then generate a concrete, step-by-step plan that maximizes the likelihood of a successful pull request (PR).
Finish by asking: “Do you want me to execute the plan?”
Guardrails
- Ask no more than 5 questions total (stop early if you have enough info).
- Progressive: each next question builds on the previous answer.
- Keep questions concise (<= 2 sentences each). Offer options when useful.
- If the user is uncertain, propose reasonable defaults and continue.
- Stop once you have enough info to create a specific PR-ready plan.
- NEVER push directly to the main or master branch. Do not automatically commit any changes to the repo.
Interview Flow
First question - always start here
“Great — what are you trying to build or change, in one or two sentences?
(e.g., add an endpoint, fix a bug, write a script, tweak UI)”
Dynamic follow-up questions
Choose the next question based on what's most relevant from the last reply.
Use one at a time - no more than 5 total.
1. Repo & Runtime Context
- “Where will this live? Repo/name or link, language/runtime, and framework (if any)?”
- “How do you run and test locally? (package manager, build tool, dev server, docker compose?)”
2. Scope & Acceptance Criteria
- “What's the smallest valuable change we can ship first? Describe the exact behavior or API/CLI/UI change and how we’ll verify it.”
- “Any non-negotiables? (performance, accessibility, security, backwards-compatibility)”
3. Interfaces & Data
- “Which interfaces are affected? (files, modules, routes, DB tables, events, components)”
- “Do we need new schema/DTOs, migrations, or mock data?”
4. Testing & Tooling
- “What tests should prove it works (unit/integration/e2e)? Which test framework, and any CI requirements?”
5. Final Clarifier
If critical information is missing, ask one short, blocking question. If not, skip directly to the plan.
Plan Generation (After Questions)
Produce a PR-ready plan customized to the user’s answers, in this structure:
1. Goal & Success Criteria
- One-sentence goal.
- Bullet acceptance tests (observable behaviors or API/CLI examples).
2. Scope of Change
- Files/modules to add or modify (with paths and stubs if known).
- Public interfaces (function signatures, routes, migrations) with brief specs.
3. Implementation Steps
- Branch creation and environment setup commands.
- Code tasks broken into <= 8 bite-sized commits.
- Any scaffolding or codegen commands.
4. Testing Plan
- Tests to write, where they live, and example test names.
- How to run them locally and in CI (with exact commands).
- Sample fixtures/mocks or seed data.
5. Quality Gates & Tooling
- Lint/format/type-check commands.
- Security/performance checks if relevant.
- Accessibility checks for UI work.
6. Risks & Mitigations
- Top 3 risks + how to detect or rollback.
- Mention feature flag/env toggle if applicable.
7. Timeline & Next Steps
- Rough estimate (S/M/L) with ordered sequence.
- Call out anything explicitly out of scope.
Final Question
“Do you want me to execute the plan?”
1---2name: onboarding-agent-23description: Interactive onboarding workflow that interviews users to understand their coding goals and generates PR-ready implementation plans. Use when starting a new development task to ensure clear requirements and structured execution.4---5
6# First-time User Conversation with OpenHands
7
8## Skill purpose
9In **<= 5 progressive questions**, interview the user to identify their coding goal and constraints, then generate a **concrete, step-by-step plan** that maximizes the likelihood of a **successful pull request (PR)**.
10Finish by asking: **“Do you want me to execute the plan?”**
11
12## Guardrails
13- Ask **no more than 5 questions total** (stop early if you have enough info).
14- **Progressive:** each next question builds on the previous answer.
15- Keep questions concise (**<= 2 sentences** each). Offer options when useful.
16- If the user is uncertain, propose **reasonable defaults** and continue.
17- Stop once you have enough info to create a **specific PR-ready plan**.
18- NEVER push directly to the main or master branch. Do not automatically commit any changes to the repo.
19
20## Interview Flow
21
22### **First question - always start here**
23> “Great — what are you trying to build or change, in one or two sentences?
24> (e.g., add an endpoint, fix a bug, write a script, tweak UI)”
25
26### **Dynamic follow-up questions**
27Choose the next question based on what's most relevant from the last reply.
28Use one at a time - no more than 5 total.
29
30#### 1. Repo & Runtime Context
31- “Where will this live? Repo/name or link, language/runtime, and framework (if any)?”
32- “How do you run and test locally? (package manager, build tool, dev server, docker compose?)”
33
34#### 2. Scope & Acceptance Criteria
35- “What's the smallest valuable change we can ship first? Describe the exact behavior or API/CLI/UI change and how we’ll verify it.”
36- “Any non-negotiables? (performance, accessibility, security, backwards-compatibility)”
37
38#### 3. Interfaces & Data
39- “Which interfaces are affected? (files, modules, routes, DB tables, events, components)”
40- “Do we need new schema/DTOs, migrations, or mock data?”
41
42#### 4. Testing & Tooling
43- “What tests should prove it works (unit/integration/e2e)? Which test framework, and any CI requirements?”
44
45#### 5. Final Clarifier
46If critical information is missing, ask **one short, blocking question**. If not, skip directly to the plan.
47
48## Plan Generation (After Questions)
49Produce a **PR-ready plan** customized to the user’s answers, in this structure:
50
51### 1. Goal & Success Criteria
52- One-sentence goal.
53- Bullet **acceptance tests** (observable behaviors or API/CLI examples).
54
55### 2. Scope of Change
56- Files/modules to add or modify (with **paths** and stubs if known).
57- Public interfaces (function signatures, routes, migrations) with brief specs.
58
59### 3. Implementation Steps
60- Branch creation and environment setup commands.
61- Code tasks broken into <= 8 bite-sized commits.
62- Any scaffolding or codegen commands.
63
64### 4. Testing Plan
65- Tests to write, where they live, and example test names.
66- How to run them locally and in CI (with exact commands).
67- Sample fixtures/mocks or seed data.
68
69### 5. Quality Gates & Tooling
70- Lint/format/type-check commands.
71- Security/performance checks if relevant.
72- Accessibility checks for UI work.
73
74### 6. Risks & Mitigations
75- Top 3 risks + how to detect or rollback.
76- Mention feature flag/env toggle if applicable.
77
78### 7. Timeline & Next Steps
79- Rough estimate (S/M/L) with ordered sequence.
80- Call out anything **explicitly out of scope**.
81
82## Final Question
83**“Do you want me to execute the plan?”**
majiayu000