benefits-guide
Writes employee benefits guides explaining health insurance, retirement plans, PTO, and perks in plain language. Use when onboarding new hires or updating benefits documentation.
- License 许可
- Apache-2.0
- 最近更新
- 2026-07-12
- Stars
- ★ 82
- Forks
- 18
01 前言 Front Matter
- name
- benefits-guide
- metadata
- { "author": "matthewhitcham", "version": "1.0" }
- description
- Writes employee benefits guides explaining health insurance, retirement plans, PTO, and perks in plain language. Use when onboarding new hires or updating benefits documentation.
- allowed-tools
- Read Write Glob
03 SKILL.md 正文
Benefits Guide
When to Use This Skill
Use this skill when you need to:
- Create an employee benefits guide for new hires
- Rewrite complex benefits information in plain language
- Document a new benefits package for your growing team
- Update an existing guide with new perks or policy changes
DO NOT use this skill for benefits plan selection, insurance broker negotiations, or legal compliance documents. This is for communicating benefits clearly to employees.
Core Principle
IF AN EMPLOYEE HAS TO ASK HR TO EXPLAIN A BENEFIT, THE GUIDE HAS FAILED — WRITE AT AN 8TH-GRADE READING LEVEL WITH CONCRETE EXAMPLES.
Phase 1: Brief
Required Inputs
| Input | What to Ask | Default |
|---|---|---|
| Benefits offered | "List all benefits you offer (health, dental, vision, 401k, PTO, remote stipend, etc.)" | Must be provided |
| Company size | "How many employees?" | 5-25 |
| Eligibility rules | "When do benefits kick in? (day 1, after 30 days, after 90 days)" | Day 1 for full-time |
| Enrollment details | "Open enrollment dates? How do employees sign up?" | Annual open enrollment |
| Audience | "New hires, all employees, or specific group?" | All employees |
| Tone | "Formal HR document or conversational guide?" | Conversational and clear |
GATE: Confirm brief before proceeding.
Phase 2: Outline
Standard Guide Sections
- Welcome and overview — what is included at a glance
- Health and wellness — medical, dental, vision, mental health
- Financial benefits — retirement, equity, bonuses
- Time off — PTO, sick days, holidays, parental leave
- Work perks — remote stipend, learning budget, wellness allowance
- Eligibility and enrollment — who qualifies, how to enroll, key dates
- FAQ — top 10 questions employees actually ask
- Contacts and resources — who to ask, where to go
GATE: Present outline and confirm which sections apply before writing.
Phase 3: Write
Writing Rules
- Use plain language — "You pay $50/month for individual coverage" not "Employee contribution for single-tier enrollment"
- Include dollar amounts and specific numbers wherever possible
- Add a real-world example for every complex benefit (especially insurance deductibles and 401k matching)
- Use comparison tables for plan options
- Bold key numbers: costs, dates, deadlines
- Include "What this means for you" callouts after technical sections
Section Format
Each benefit section follows this structure:
- What it is — one-sentence plain-language explanation
- What you get — specific coverage, amounts, or allowances
- What it costs you — employee contribution if any
- How to use it — enrollment steps, claims process, or access instructions
- Example — concrete scenario showing the benefit in action
Phase 4: Polish
Final Deliverables
- Complete benefits guide — formatted for the stated audience
- Quick-reference card — one-page summary with key numbers and dates
- New hire email template — welcome message pointing to the guide with enrollment deadlines
- FAQ section — answers to the 10 most common benefits questions
Example 1: Startup Benefits Guide (15 people, basic package)
Health: Company covers 80% of premiums. You pay ~$120/month for individual, ~$350/month for family. PTO: Unlimited PTO with a 2-week minimum encouraged. No accrual, no payout. Learning: $500/year learning stipend for courses, books, or conferences.
Example 2: Growing Company (50 people, comprehensive package)
Health: Choice of two plans — PPO ($150/mo) or HDHP with HSA ($80/mo + $1,500 company HSA contribution). Retirement: 401(k) with 4% company match, vested immediately. Parental Leave: 12 weeks paid for all parents, biological or adoptive.
Anti-Patterns
- Insurance jargon without translation — "coinsurance," "out-of-pocket maximum," and "deductible" need plain-English definitions with examples.
- Missing dollar amounts — "competitive benefits" means nothing. Show the numbers.
- Burying enrollment deadlines — if someone misses open enrollment because it was on page 47, the guide failed. Put dates up front.
- One giant PDF — break it into scannable sections with a table of contents. Nobody reads a 30-page document cover to cover.
- Forgetting part-time or contractor differences — if eligibility varies, state it clearly per employment type.
Recovery
- User unsure of benefit details: Ask for their insurance broker contact or benefits portal login page. Work with available information and flag gaps.
- Very few benefits to document: Focus on what exists and frame it positively. Even PTO and flexible hours deserve a clear writeup.
- Benefits vary by location: Create a base guide with location-specific addenda or comparison tables.
- User wants to attract talent with the guide: Shift tone toward employer branding — emphasize total compensation value and unique perks.
04 同仓库更多 Skills
로인장 (Roinjiang)
Activates when the user needs legal advice, contract review, insurance law consultation, startup legal support, or any legal/regulatory matter. She is a top-tier in-house lawyer with absolute loyalty to the CEO, specializing in insurance law, financial consumer protection, privacy, contracts, labor law, family law, civil and criminal matters.
zocdoc-doctor-finder
Use when a user needs to find a doctor, dentist, specialist, therapist, or healthcare provider — especially when they mention insurance, in-network, availability, location, appointments, or booking. Also use for browsing provider reviews, comparing doctors by specialty, or checking if a provider takes their insurance.
zenmux-context
Answers any question about ZenMux by reading the latest official documentation. Use this skill whenever the user asks about ZenMux product features, API usage, configuration, integration, pricing, models, providers, routing, fallback, streaming, multimodal, structured output, tool calling, reasoning, prompt caching, image generation, video generation, web search, long context, observability, logs, cost tracking, usage analytics, insurance, subscription, pay-as-you-go, invoices, best practices for tools like Claude Code, Cursor, Cline, CodeX, Gemini CLI, opencode, Cherry Studio, Obsidian, Sider, Open-WebUI, Dify, Neovate, GitHub Copilot, OpenClaw, CC-Switch, Immersive Translate, Studio Chat, architecture, benchmarks, FAQ, contact, privacy, terms of service, compliance, or any other ZenMux-related topic. Also trigger when the user writes in Chinese about ZenMux: 文档, 使用指南, 快速开始, API 参考, 最佳实践, 模型路由, 供应商路由, 订阅, 按量计费, 可观测性, 帮助, 常见问题, 接入指南, 配置. Trigger on phrases like "how to use ZenMux", "ZenMux docs", "ZenMux API", "ZenMux integration", "ZenMux 怎么用", "ZenMux 接入", "ZenMux 配置". Even if the user doesn't say "ZenMux" explicitly but asks about LLM API aggregation, model routing, provider fallback in a context where ZenMux is the project being worked on, this skill should activate.
workers-comp-guide
Guide workers compensation compliance and claims management. TRIGGERS - Use when user needs help with workers-comp-guide related tasks.
weekly-kpi-report
Generate McKinsey-style board presentation PPTs from weekly auto insurance data. Automatically calculates 16+ KPIs, creates executive-level slides with actionable insights, and supports week-over-week comparisons. Use when user uploads insurance cost data (Excel/CSV) and requests board report, weekly presentation, executive briefing, or mentions keywords like 董事会汇报, 周报PPT, 经营分析演示, McKinsey-style reports.
wealth-advisory
Wealth management and financial planning for HNW and UHNW clients. Activate when the user mentions wealth management, financial planning, retirement, estate planning, tax planning, GRAT, IDGT, trust, asset allocation, withdrawal rate, Monte Carlo simulation, goals-based investing, tax-loss harvesting, Roth conversion, insurance, annuity, mortgage strategy, concentrated stock, family office, direct indexing, 529 plan, charitable giving, donor-advised fund, private foundation, or asks about personal finance strategy, inheritance, long-term financial planning, or UHNW advisory.