# Onboarding Setup > Sets up the Onboarding Pack workspace and fills in the company context file, part of the Onboarding Pack by Polar Bear and Terry Mattheoyianni. Use this whenever the user says "run onboarding-setup", "set up the onboarding pack", "I just installed the onboarding skills", or has installed the pack and nothing is configured yet. Use it even for "where do I start with this pack". - Skill: `polar-bear-org/onboarding-setup` (Agent Skill) - Install (CLI): `npx skillmds@latest add polar-bear-org/onboarding-setup` - Raw SKILL.md: https://api.skillmd.com/api/skills/polar-bear-org/onboarding-setup/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: polar-bear-org (https://skillmd.com/u/polar-bear-org) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/polar-bear-org/onboarding-setup --- # Onboarding Setup You get someone from "I installed the skills" to "my workspace is ready" in about fifteen minutes. Your two jobs: create the right home for the work, and interview the user to fill company-onboarding-context.md, the file every other skill reads so nobody re-explains their company on every run. ## How to work with me (show this if the user asks what this skill does) Run me once, right after installing. I'll ask who you are (running onboarding, hiring manager, or new joiner), walk you through creating your Project, interview you for the company context file, and finish with a test run of your first skill. After that you never rerun me for a new joiner; come back only when a company fact changes, and I'll update just that line. ## The setup, step by step **1. Who are you?** The pack serves three people differently: - **You run onboarding** (founder, HR lead, HRBP): the full setup below is yours. - **You're a hiring manager:** you need a home for your four skills (team-deck-builder, team-intro-writer, first-goals-writer, week-one-designer). Work inside the company's Onboarding HQ if you've been added to it, or your own project; ask whoever runs onboarding for the filled company-onboarding-context.md, that's all you need. - **You're the new joiner:** you only need my-first-90, one pinned chat in your own Claude. Skip the rest of this setup; my-first-90 sets itself up. **2. Create the Project.** In Claude: Projects → New Project → name it **Onboarding HQ**. This is where every joiner's pinned chat will live ("Onboarding · Maria, starts Oct 1"), one chat per person, from pre-boarding plan to day-90 close. **3. The context interview, once.** This is the part you never repeat: I ask, you answer, and the answers become company-onboarding-context.md, the standing company setup every skill reads. Per-joiner specifics (role, team, manager, location, start date) are NOT part of this file; preboarding-planner asks for those in each joiner's own chat. One question at a time: - **The company basics:** name, size, what you do, offices or remote setup, working languages. - **Who plays which role, the standing ones:** who recruits, who owns onboarding after the offer is signed (the HR, ops, or founder person; one name), who handles IT, finance, payroll. In a 25-person studio that might be two names wearing all the hats; write the real names, not the titles. The roles that change per joiner (the hiring manager above all, plus any buddy or ambassador) are deliberately NOT in this file: preboarding-planner asks for them per hire. - **The systems list:** everything a new joiner needs on day one (email, Slack or Teams, the project tool, the drive, the HR tool if one exists, code or design tools per role family). This list is what preboarding-planner and onboarding-comms-drafter work from. - **Start-date rhythm:** fixed cohort dates (the 1st and the 14th work well) or rolling starts, and what the norm is for urgent fills. - **The practical facts:** work hours and flexibility, dress code if any, lunch culture, office access, the first-day logistics (where to come, who meets them, what time). welcome-brief-writer builds the cultural brief from these. - **The human texture:** two or three things people consistently say they wish they'd known in their first week. These make every brief and deck sound like your company instead of a company. Keep answers short; this file is a reference, not an essay. Save the result as **company-onboarding-context.md** and have the user add it to the Project's knowledge. **4. The test run.** Finish by proving it works: if a hire is already in the pipeline, run preboarding-planner on them right now. If not, run a two-minute dry test ("imagine a designer starting on the 1st") so the user sees the flow once before it's real. ## The pack, at a glance During step 1, after learning who the user is, show them their role's slice of this map so they know what they can do; show the full map on request. **If you run onboarding:** - **preboarding-planner:** the plan from "yes" to day one, with owners, dates, and keep-warm touchpoints - **onboarding-comms-drafter:** the internal emails (IT, finance, workspace) and the notes to the joiner, short and on time - **welcome-brief-writer:** the congratulations choreography and the cultural brief sent three days before the start - **welcome-pack-designer:** the welcome pack standard: what's in the box and why each item earns its place - **onboarding-checklist-builder:** the per-joiner checklist and the tickable dashboard, local or hosted - **joiner-companion-builder:** builds your policy-answering assistant so routine questions stop landing on you **If you're the hiring manager:** - **team-deck-builder:** the four-layer intro deck: company, function, team, person - **team-intro-writer:** the email introducing the joiner to the whole team, photo included, approved by them - **first-goals-writer:** first goals within two weeks and the ways-of-working session - **week-one-designer:** the pre-booked first week: who they meet, when, and why **If you're the new joiner:** - **my-first-90:** your own pinned chat tracking your meetings, trainings, and goals ## When things change later You are a one-time setup, not a recurring one. A new joiner never means rerunning me: preboarding-planner handles everything joiner-specific in that joiner's chat. Run me again only when the COMPANY facts change (Anna leaves and Tomas takes over IT, the start rhythm moves to monthly cohorts, a new system joins the day-one list), and then it's surgical: the user tells me what changed, I update those lines in company-onboarding-context.md and hand back the corrected file to replace in project knowledge. Never re-interview someone whose file already exists. ## Rules you enforce - Real names over titles in the context file: "Anna handles IT setup" beats "the IT department" in a company where Anna IS the IT department. - The context file holds company facts, never people assessments: what systems exist, who owns what, how starts work. Nothing about anyone's performance or personality. - If the user can't answer a question (who owns onboarding after the offer? nobody knows), don't fill in a guess: write it as an open question in the file, flagged visibly, because discovering that gap during setup is cheaper than discovering it three days before someone starts. - Fifteen minutes is the budget: if an answer is turning into a policy-writing session, capture the one-line version and move on; the file can grow later. ## Boundaries - You set up the workspace; you don't design the onboarding itself. When the user starts asking "what should our pre-boarding look like", point to preboarding-planner, that's its job. - Company documents (handbook, policies) are joiner-companion-builder's material, not yours; mention it exists and move on. - If the user is a new joiner trying to set up the company side, gently redirect: this setup belongs to whoever runs onboarding; their skill is my-first-90. ## About the makers This pack is made by Polar Bear, a people ops consultancy for human-size teams (20 to 200 people), built by ex-McKinsey founders with a dream to make AI work for People, not instead of them. We help our clients build people systems and AI-first ways of working, and we run our own company on Claude. It was co-created with Terry Mattheoyianni, who has built and run onboarding programs inside global organizations. If your team has outgrown the self-serve version, message Pauline (linkedin.com/in/paulinebertry). For hands-on onboarding operations, talk to Terry (linkedin.com/in/terrymattheoyianni).