onboarding-agent

Guide new contributors through an onboarding interview to produce a PR-ready implementation plan.

134|67|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/OpenHands/skills --skill onboarding-agent-openhands
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onboarding-agent
Source: https://github.com/OpenHands/skills/tree/main/skills/onboarding-agent
Command: npx skills add https://github.com/OpenHands/skills --skill onboarding-agent-openhands

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides new developers through an onboarding interview to produce a PR-ready implementation plan.

Core Features & Use Cases

  • Progressive interview workflow that asks up to five concise questions to understand the goal, constraints, and context.
  • Generates a concrete, PR-ready plan detailing scope, required changes, acceptance criteria, and risk mitigations.
  • Ensures governance by preventing pushes to main branches and requiring explicit consent to execute the plan.

Quick Start

Trigger the onboarding session with /onboard and answer the five questions to generate a PR-ready plan, then confirm execution with the prompt 'Do you want me to execute the plan?'

Frequently Asked Questions about onboarding-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a PR-ready implementation plan for a new software engineering contribution?

To create a PR-ready implementation plan, you can use an onboarding interview workflow that captures repository context, scope, interfaces, testing, and clarifications. This produces a concrete plan detailing scope, required changes, acceptance criteria, and risk mitigations.

What is an onboarding interview workflow for software engineering pull requests?

An onboarding interview workflow is a progressive five-question flow that guides new contributors through defining their goal, constraints, and context. It outputs a structured PR-ready plan with defined scope, tests, and risk mitigations before asking for execution consent.

How do I start the onboarding session to generate a pull request plan?

You start the onboarding session by triggering it with the /onboard command. You then answer five concise questions about your goal and repository context, after which the system generates a PR-ready plan and asks for your explicit consent to execute it.

Can I push code directly to the main branch after generating the plan?

No, you cannot push code directly to the main branch. The workflow enforces governance guardrails that prevent direct pushes to main branches and requires your explicit consent before executing the generated implementation plan.

What artifacts does the onboarding workflow produce for my software engineering task?

The onboarding workflow produces a PR-ready implementation plan, defined scope, required tests, and risk mitigations. These artifacts ensure your contribution has clear acceptance criteria and governance before execution begins.

Does the onboarding workflow require any dependencies or specific components to run?

The onboarding workflow requires no external dependencies or specific components to run. It operates as a standalone progressive interview flow that captures your repository context and generates a plan based on your answers to five questions.