Wellness Program Generator

Your corporate wellness content creation platform — generating challenges, newsletters, assessments, and reports in minutes instead of hours.

Important: All documents generated by this plugin are drafts intended as starting points. Clinical and healthcare documents must be reviewed by a qualified healthcare professional before use. This plugin does not provide medical advice and is not a substitute for professional clinical judgment. Ensure all output complies with your organization's HIPAA policies and applicable regulations.

1. Overview & Value Proposition

The Wellness Program Generator is a free, fully customizable alternative to expensive wellness platforms like Wellable ($1,200-6,000/yr), Wellness360, and Vantage Fit. Instead of paying per-employee fees for content generation bundled with features you may not need, this plugin generates professional wellness documents locally on your machine.

What This plugin is an alternative to:

• Wellable's wellness challenge templates and content library
• Newsletter content generation from health tip databases
• Ergonomic assessment templates and scoring
• Program participation reporting and ROI estimation

What it doesn't replace:

• Real-time wearable device tracking (Fitbit, Apple Health integration)
• Live leaderboards and mobile apps
• Persistent employee health data storage
• Automated email scheduling and reminders

Cost displacement: $1,200-6,000/year → included with your subscription (this plugin costs nothing)

2. Who This Is For

Ideal Users:

• HR coordinators and wellness managers at SMBs (50-500 employees)
• Companies currently spending $1,200-6,000/yr on wellness platform subscriptions
• Teams that need wellness content without device tracking complexity
• Organizations wanting to keep employee health data local (not cloud-hosted)

Not For:

• Enterprise teams (500+ employees) requiring real-time analytics and SSO
• Companies needing informed by HIPAA guidelines health record storage (this plugin generates documents, not medical records)
• Organizations requiring live wearable device integration and activity tracking

3. Core Features

Challenge Generation

Generate complete wellness challenge packages with:

• Daily/weekly task schedules with point values
• Official rules and scoring systems
• Prize tier structures (Bronze/Silver/Gold)
• Communication templates (kickoff email, weekly reminders, completion announcement)
• Participant tracking spreadsheets

Supported challenge types: Step challenges, meditation, hydration, nutrition, team competitions, mental wellness, financial wellness, and custom types.

Newsletter & Health Content

Generate industry-specific health tip newsletters with:

• Featured articles (150-300 words) with source citations
• 5-7 quick tips categorized by wellness pillar
• Seasonal spotlight connected to current time
• Evidence-based content with "research suggests" qualification language
• Crisis resources for sensitive mental health topics

Edition types: Weekly (quick tips), monthly (deep-dive articles), special (awareness months).

Ergonomic Assessments

Generate role-specific ergonomic self-assessments with:

• 5-7 evaluation categories (15-25 checklist items)
• Point-based scoring with 4+ performance levels
• Prioritized improvement recommendations with cost estimates
• Phased action plans (immediate/short-term/long-term)

Supported role types: Office, remote, hybrid, warehouse, field, and specialized roles.

Program Reporting

Generate program effectiveness reports from participation data CSV with:

• Program-by-program analysis (completion rates, satisfaction scores)
• Organization-level engagement metrics and trends
• ROI estimates using published workplace wellness research
• Data-driven recommendations for future programming

4. Quick Start

Initial Setup (One-Time)

/wellness:wellness-setup

This creates your workspace folders, validates dependencies, and collects company information (name, industry, wellness focus, branding preferences).

Generate Your First Challenge

/wellness:wellness-challenge step-challenge 4 2026-04-06

This generates a 4-week step challenge starting April 6, 2026, with daily tasks, rules, and communication templates.

Create a Health Newsletter

/wellness:wellness-newsletter weekly stress-management

This generates a professional health tip newsletter on stress management tailored to your industry.

Create an Ergonomic Assessment

/wellness:wellness-ergonomic office

This generates an office ergonomic self-assessment checklist with scoring and recommendations.

Generate a Program Report

/wellness:wellness-report Q1 inbound/participation-data.csv

This analyzes participation data from a CSV file and generates a program effectiveness report with ROI estimates.

5. Installation & Setup

Prerequisites

• Python 3.7+ (check with: python3 --version)
• Node.js and npm (for docx template processing)

Installation Steps

1. Install the plugin via Cowork plugin marketplace or direct installation

2. Run setup command: /wellness:wellness-setup

   • Creates workspace folders
   • Validates dependencies
   • Gathers company information
   • Creates .wellness/config.json

3. Customize templates (optional):

   • Templates are copied to {your-folder}/pf-wellness-programs/templates/
   • Open in Word to add your logo, fonts, colors
   • Keep {{placeholder}} markers intact
   • Changes apply to all future documents

4. Test with first challenge: /wellness:wellness-challenge step-challenge 4

6. Commands Reference

Core Commands

Command	Purpose	Example
wellness-setup	Initialize workspace	/wellness:wellness-setup
wellness-challenge	Generate challenge	/wellness:wellness-challenge step-challenge 4 2026-04-06
wellness-newsletter	Generate newsletter	/wellness:wellness-newsletter weekly stress-management
wellness-ergonomic	Generate assessment	/wellness:wellness-ergonomic office-hybrid
wellness-report	Generate report	/wellness:wellness-report Q1 inbound/participation-data.csv
wellness-full-program	Generate all Q content	/wellness:wellness-full-program Q2 inbound/participation.csv
wellness-status	Check workspace	/wellness:wellness-status

Challenge Types

• step-challenge — Step and activity tracking
• meditation-challenge — Mindfulness and meditation
• hydration-challenge — Daily water intake
• nutrition-challenge — Healthy eating
• team-competition — Team-based activity
• mental-wellness-challenge — Mental health focus
• financial-wellness-challenge — Financial health
• Custom types supported

Newsletter Types

• weekly — 5-7 quick tips (5 min read)
• monthly — 2-4 featured articles + tips (15-20 min read)
• special — Themed edition (awareness months, special topics)

Newsletter Topics

• Stress management, nutrition, hydration, mental health
• Physical fitness, sleep, financial wellness, ergonomics
• Work-life balance, and custom topics

Role Types (Ergonomic Assessment)

• office — Desk-based in-office
• remote — Work-from-home
• office-hybrid — Mix of office and home
• warehouse — Material handling
• field — Outdoor/mobile work
• Custom roles supported

7. File Structure & Organization

After running /wellness:wellness-setup, your workspace looks like this:

{working-directory}/
├── inbound/                    ← Upload CSVs here (participation data, etc.)
├── processing/                 ← Intermediate work files
├── outbound/                   ← Final generated documents
├── archive/                    ← Completed documents (30-day retention)
├── .wellness/
│   ├── config.json            ← Runtime configuration
│   └── logs/
│       └── setup-{timestamp}.log
└── .gitignore

{local-machine}/pf-wellness-programs/     ← Persistent, survives sessions
├── templates/                  ← Edit to customize
│   ├── challenge-base.docx
│   ├── newsletter-base.docx
│   ├── ergonomic-base.docx
│   ├── report-base.docx
│   ├── challenge-settings.json
│   ├── newsletter-settings.json
│   ├── ergonomic-settings.json
│   ├── report-settings.json
│   └── README.md
├── inputs/                     ← Persistent input files
├── outputs/                    ← Final documents (visible to you)
│   ├── wellness-challenge-step-challenge-2026-03-03.docx
│   ├── wellness-newsletter-2026-03-03.docx
│   ├── ergonomic-assessment-office-2026-03-03.docx
│   └── wellness-report-Q1-2026-03-31.docx
└── config.json

8. Configuration & Customization

Company Profile (.wellness/config.json)

The setup command creates a configuration file with:

{
  "company": {
    "name": "Your Company",
    "industry": "technology",
    "employee_count": 150,
    "office_type": "hybrid",
    "locations": ["Austin, TX"]
  },
  "wellness_program": {
    "focus_pillars": ["physical", "mental"],
    "current_initiatives": ["Gym reimbursement", "EAP"]
  },
  "branding": {
    "tone": "friendly-professional",
    "newsletter_header": "Your Company Wellness Weekly"
  },
  "preferences": {
    "include_mental_health_content": true,
    "include_financial_wellness": true,
    "seasonal_content": true
  },
  "legal": {
    "health_disclaimer": "...",
    "ergonomic_disclaimer": "..."
  }
}

Customizing Templates

1. Locate templates: {local-folder}/pf-wellness-programs/templates/
2. Open in Word: challenge-base.docx, newsletter-base.docx, etc.
3. Customize:
   • Add your company logo
   • Change fonts and colors to match brand
   • Adjust headers and footers
   • Modify spacing and layout
4. Save: Keep placeholder markers like {{company_name}} intact
5. All documents will use your customized template for future generation

Modifying Focus Areas

Edit .wellness/config.json and change:

• company.industry — Change how content is tailored
• wellness_program.focus_pillars — Which wellness dimensions to emphasize
• preferences.include_mental_health_content — Include/exclude mental health topics
• branding.tone — Friendly-professional, formal, casual, or motivational

Run /wellness:wellness-setup again to update.

9. How to Use Each Skill

1. Wellness Challenge

Command:

/wellness:wellness-challenge {type} {weeks} [start_date]

Example:

/wellness:wellness-challenge step-challenge 4 2026-04-06

Output:

• Professional DOCX with challenge details, rules, and schedule
• CSV tracking template for participants
• Email templates (kickoff, weekly reminder, completion)

Next steps:

• Review challenge in Word (customize if needed)
• Share kickoff email with team
• Distribute tracking spreadsheet
• Send weekly reminder emails manually each Monday

2. Health Newsletter

Command:

/wellness:wellness-newsletter {edition} {topic}

Example:

/wellness:wellness-newsletter weekly stress-management
/wellness:wellness-newsletter monthly nutrition

Output:

• Professional DOCX newsletter with articles and quick tips
• Evidence-based content with source citations
• Industry-specific examples

Tips:

• Generate 4 weekly newsletters at once for a month of content
• Batch generate and schedule distribution through your email system
• Customize company-specific references before sending

3. Ergonomic Assessment

Command:

/wellness:wellness-ergonomic {role_type}

Example:

/wellness:wellness-ergonomic office-hybrid
/wellness:wellness-ergonomic warehouse

Output:

• Self-assessment checklist with scoring rubric
• Prioritized recommendations with cost estimates
• Phased action plan (immediate, short-term, long-term)

Typical workflow:

1. Share document with employees
2. Employees complete self-assessment
3. HR reviews results and plans improvements
4. Implement immediate (no-cost) actions first
5. Request budget for short-term improvements
6. Re-assess in 3 months

4. Program Report

Command:

/wellness:wellness-report {period} {csv_path}

Example:

/wellness:wellness-report Q1 inbound/participation-data.csv

CSV format:

employee_id,program_name,enrolled_date,completed,completion_date,satisfaction_score
EMP001,Spring Step Challenge,2026-03-15,Yes,2026-04-30,5
EMP002,Spring Step Challenge,2026-03-15,No,,

Output:

• Program-by-program completion rates
• Organization engagement metrics
• ROI estimate with methodology
• Strategic recommendations for next quarter

Typical workflow:

1. Run wellness programs and collect participation data
2. Upload CSV to inbound/ folder
3. Generate report: /wellness:wellness-report Q1 inbound/participation.csv
4. Present findings to leadership
5. Use recommendations for Q2 planning

10. Health & Legal Disclaimers

Health Content Disclaimer (MANDATORY)

This content is for informational purposes only and does not constitute medical advice. Always consult a qualified healthcare professional before starting any wellness program or making changes to your health routine.

This disclaimer appears in every generated document (challenges, newsletters, ergonomic assessments, reports).

Ergonomic Disclaimer (MANDATORY)

This self-assessment is a general guide for workplace ergonomics. For specific workplace accommodations or persistent discomfort, consult a certified ergonomist or occupational health professional.

This disclaimer appears in every ergonomic assessment.

Sensitive Topics

If generating content on sensitive mental health topics (suicide, self-harm, eating disorders, addiction):

• Crisis resources are automatically included:
  • 988 Suicide & Crisis Lifeline: Call or text 988
  • SAMHSA National Helpline: 1-800-662-4357
• Content uses supportive, non-diagnostic language
• Professional referral language emphasized

AI-Powered Features

• Behavior Change Science: Challenges designed using Transtheoretical Model (Prochaska & DiClemente) stages of change and Self-Determination Theory (Deci & Ryan) for autonomy, competence, and relatedness
• Evidence-Based Challenge Design: Duration recommendations grounded in habit formation research (Lally et al., 2010 — 66-day average) and engagement drop-off data (Chapman, 2012)
• Regulatory-Grounded Ergonomics: Assessments reference OSHA standards (General Duty Clause, 29 CFR 1910), ANSI/HFES 100-2007, ISO 9241, and NIOSH Lifting Equation with ADA Title I accommodation pathways
• Dual ROI/VOI Analysis: Reports use both traditional ROI (Baicker et al., 2010 Harvard meta-analysis; RAND 2013) and Value on Investment framework (HERO Economics Committee) with presenteeism measurement
• Health Literacy Compliance: Newsletters follow CDC Clear Communication Index guidelines (6th-8th grade reading level) with Health Belief Model article structure
• Framework Alignment: All skills mapped to WELCOA 7 Benchmarks, HERO Scorecard, CDC Workplace Health Model, NIOSH Total Worker Health, and Healthy People 2030 objectives
• Industry-Tailored Content: Customizes wellness activities and messaging for technology, healthcare, construction, and other industries with NAICS sector mapping
• 8-Dimension Wellness Model: Content organized across SAMHSA's 8 Dimensions of Wellness (emotional, environmental, financial, intellectual, occupational, physical, social, spiritual)
• Compliance-Aware Design: Setup captures EEOC wellness program regulations, HIPAA classification, and ACA incentive limits for legally defensible programming

11. Troubleshooting & FAQ

Setup Issues

"Wellness configuration not found"

• Run /wellness:wellness-setup first
• Check that .wellness/config.json was created

"Python 3 not found"

• Install Python 3: https://python.org/downloads
• Run: python3 --version to verify
• Re-run /wellness:wellness-setup

"docx package not found"

• Install Node.js if not already installed
• Run: npm install python-docx
• Re-run /wellness:wellness-setup

Document Generation Issues

"Template file not found"

• Check that templates exist in local folder: {local-folder}/pf-wellness-programs/templates/
• Re-run /wellness:wellness-setup to re-copy templates
• Verify template files: challenge-base.docx, newsletter-base.docx, etc.

"No placeholder text in output"

• Check template files aren't corrupted
• Verify template files are valid DOCX format
• Try regenerating the document

"CSV parsing failed"

• Check CSV file is in correct location: inbound/filename.csv
• Verify required columns: employee_id, program_name, enrolled_date, completed, satisfaction_score
• Check for special characters in CSV that need escaping

Performance & Optimization

Generation is slow:

• First generation of template is slower (template preparation)
• Subsequent generations are faster (cached)
• Batch generation (multiple newsletters at once) is more efficient

Documents are large (10+ MB):

• Templates may include embedded images
• Edit templates to remove unnecessary images
• Regenerate document after template editing

Data & Privacy

"Employee health data leaked or exposed"

• This plugin does NOT send data to cloud services
• All data stays local on your machine
• Generated documents are saved locally
• No third-party analytics or tracking
• Delete documents manually when no longer needed

12. Advanced Usage & Tips

Batch Newsletter Generation

Generate 4 weeks of newsletters with one command:

/wellness:wellness-newsletter weekly stress-awareness
/wellness:wellness-newsletter weekly nutrition
/wellness:wellness-newsletter weekly physical-activity
/wellness:wellness-newsletter weekly mental-health

This creates 4 distinct newsletters with non-overlapping content ready to schedule.

Multi-Role Ergonomic Assessments

Generate assessments for multiple employee groups:

/wellness:wellness-ergonomic office
/wellness:wellness-ergonomic warehouse
/wellness:wellness-ergonomic remote

Create separate assessments for each role type, then distribute to relevant teams.

Full Quarterly Program

Generate complete Q2 content in one command:

/wellness:wellness-full-program Q2 inbound/q1-participation.csv

This orchestrates:

1. Challenge generation (4-week program)
2. 4 weekly newsletters (different topics)
3. Ergonomic assessment
4. Program report (analyzing Q1 data)

Result: Entire quarter's wellness content in 15-20 minutes

Customization Workflow

1. Generate document: /wellness:wellness-challenge step-challenge 4
2. Open in Word: {local-folder}/outputs/wellness-challenge-*.docx
3. Customize: Add company details, adjust tone, modify examples
4. Save as new file: wellness-challenge-spring-2026-final.docx
5. Share with team

ROI Tracking

Collect participation data continuously:

employee_id,program_name,enrolled_date,completed,completion_date,satisfaction_score
EMP001,Spring Step Challenge,2026-03-15,Yes,2026-04-30,5

Generate quarterly reports to track:

• Participation trends
• Completion rates
• Engagement growth
• Estimated ROI and savings

13. Support & Community

Getting Help

Command not working?

• Check syntax: /wellness:wellness-{skill} (all lowercase)
• Verify arguments are provided: /wellness:wellness-challenge step-challenge 4
• Run /wellness:wellness-status to check workspace

Document looks wrong?

• Templates may need customization in Word
• Check that placeholders weren't accidentally deleted
• Regenerate document to try again

Data issue?

• Verify CSV columns match required format
• Check for encoding issues (save as UTF-8)
• Manually validate a few rows for accuracy

Reporting Issues

Document any issues you encounter:

• Command name and exact text used
• Error message (copy-paste full message)
• Steps to reproduce
• Your operating system and Python version

14. Known Limitations

This plugin generates wellness content documents — it does NOT replace a full wellness platform with real-time tracking.

1. No real-time device integration: Cannot track steps, heart rate, or activity data from wearables (Fitbit, Apple Health, etc.). For activity tracking, use free companion apps like Google Fit or Apple Health alongside this plugin's content generation.

2. No persistent scheduling or automated reminders: Cannot send automated weekly health tips or challenge reminders between sessions. Generate content in batches (e.g., 4 weeks of newsletters at once) and schedule distribution through your existing email or Slack tools.

3. No persistent database for participation tracking: Employee participation data is not automatically collected. Maintain a simple spreadsheet (CSV) and import it when generating reports with /wellness:wellness-report.

4. No multi-user real-time collaboration: HR team members cannot collaboratively edit wellness content in real-time like a SaaS dashboard. Generated DOCX files can be shared via Google Docs, SharePoint, or email for collaborative review.

5. Content is informational, not medical advice: All health-related content includes mandatory disclaimers. This plugin generates general wellness information and should not be used as a substitute for professional medical guidance.

6. CSV row limits in full-program mode: When running /wellness:wellness-full-program (all skills sequentially), the report skill handles approximately 200 CSV rows. For larger datasets, run /wellness:wellness-report as a standalone command (supports 500+ rows).

15. Version & License

• Version: 1.1
• Author: PF Plugin Factory

---

Ready to get started? Run /wellness:wellness-setup now to initialize your wellness workspace.

All generated content is yours to customize and distribute. Download documents, edit in Word, and share with your team. No licensing fees, no cloud storage, no third-party tracking.

Health Disclaimer: All wellness content generated by this plugin is for informational purposes only and does not constitute medical advice. Always consult a qualified healthcare professional before starting any wellness program or making changes to your health routine.

Commands

• /wellness:wellness-challenge — Wellness Challenge
• /wellness:wellness-ergonomic — Wellness Ergonomic
• /wellness:wellness-full-program — Wellness Full Program
• /wellness:wellness-newsletter — Wellness Newsletter
• /wellness:wellness-report — Wellness Report
• /wellness:wellness-setup — Wellness Setup
• /wellness:wellness-status — Wellness Status

Estimated Cost per Use

Disclaimer: Token estimates are approximate and based on typical usage patterns measured from skill prompt sizes. Actual costs vary with input data size, conversation length, and complexity. Estimates use Claude Sonnet 4.6 pricing ($3/1M input, $15/1M output). Cowork and Claude Desktop subscription users (Pro/Max/Team) are not charged per-token — these estimates apply only to direct Anthropic API usage. Running stages individually in fresh sessions uses fewer input tokens than running the full pipeline sequentially, because pipeline mode accumulates conversation history across stages.

Per skill (run individually in a fresh session):

Stage	Skill Prompt	User Input	Total Input	Output	Est. Cost
wellness-ergonomic	~8.6K	~800	~12.5K	~6.0K	~$0.13
wellness-challenge	~7.9K	~800	~11.8K	~6.0K	~$0.13
wellness-newsletter	~8.4K	~800	~12.3K	~6.0K	~$0.13
wellness-report	~8.8K	~800	~13.0K	~6.0K	~$0.13
Standalone total			~49.7K	~24.0K	~$0.51

Full pipeline (all stages in one session — context accumulates):

Stage	Base Input	+ History	Total Input	Output	Est. Cost
wellness-ergonomic	~12.5K	0	~12.5K	~6.0K	~$0.13
wellness-challenge	~11.9K	~6.8K	~18.7K	~6.0K	~$0.15
wellness-newsletter	~12.4K	~13.6K	~26.0K	~6.0K	~$0.17
wellness-report	~12.8K	~20.4K	~33.2K	~6.0K	~$0.19
Pipeline total			~90.4K	~24.0K	~$0.63

Running the full pipeline once typically costs $0.44–$0.82 in API tokens (Claude Sonnet 4.6).

Important Disclaimers

• AI-Generated Content: This plugin uses AI (LLM) technology which can produce inaccurate or incomplete outputs. All content should be treated as a starting point and reviewed for accuracy before use.
• Not Professional Advice: Outputs do not constitute legal, financial, tax, medical, or other professional advice. Consult qualified professionals before making decisions based on generated content.
• No Compliance Guarantee: References to industry standards, regulations, or guidelines are for informational purposes only. This plugin does not guarantee compliance with any law or regulation. Users are responsible for verifying all outputs meet their specific regulatory requirements.
• No Endorsement or Affiliation: Mention of third-party products, standards, or organizations does not imply endorsement, partnership, or certification by those entities.
• Not Medical or Health Advice: Health and medical-related outputs are not a substitute for professional medical advice, diagnosis, or treatment. Always consult a licensed healthcare provider for health-related decisions.