Merge pull request #2 from xmartlabs/feat/humanize-docs

docs: update some README copies and clean up vytallink docs

Author: dmariano001

README.md

@@ -1,55 +1,57 @@
-# 🛠️ Xmartlabs Toolkit | Out-of-Pocket: Hardware Edition
+# Xmartlabs Toolkit | Out-of-Pocket: Hardware Edition
 
-Welcome to the [**Out-of-Pocket: Hardware Edition**](https://www.outofpocket.health/hackathon-hardware-edition) Hackathon!
+Welcome to the [Out-of-Pocket: Hardware Edition](https://www.outofpocket.health/hackathon-hardware-edition) Hackathon!
 
-As a proud sponsor, [**Xmartlabs**](https://xmartlabs.com/) is dedicated to helping teams bridge the gap between innovative health hardware and scalable, compliant software ecosystems. We know that in a hackathon, time is your most scarce resource.
+[Xmartlabs](https://xmartlabs.com/) is sponsoring this event. Hackathons move fast, so we built these tools to cut setup time for teams working with health hardware and software.
 
-This repository provides a set of tools and building blocks designed by Xmartlabs to accelerate your development. They can be combined depending on your use case, handling the heavy lifting of device connectivity and data integration so you can focus on solving critical healthcare infrastructure problems.
+This repository has tools and building blocks you can combine based on your use case. They handle device connectivity and data integration, so you spend less time on plumbing and more time on your product.
 
-## 🚀 Getting Started
-
-To get the most out of these resources, we recommend:
-1. **Forking this repo** to your team's organization.
-2. **Reviewing the Tools below** to identify how they fit your project.
-3. **Checking the `examples/` folder** for quick-start scripts and implementation guides.
-
-## 🧰 Our Toolkit
+## Our Toolkit
 
 | Tool | What it is | Best For... | Quick Start |
 | :--- | :--- | :--- | :--- |
-| **VytalLink Mobile App** | Mobile application that connects wearable data and health information from your device. | Teams that need a fast path to connect health data sources without building each device integration from scratch. | [Deep Dive](tools/vytallink/README.md) |
-| **MCP Interface** | MCP interface that allows AI agents to securely query this data. | AI-powered experiences that need permissioned access to wearable and health data. | [Deep Dive](tools/vytallink/README.md) |
+| **VytalLink** | Mobile app + MCP interface that connects wearable health data to AI agents. Reads from Apple Health and Health Connect; exposes it via MCP. | Teams that need health data in their AI agent without building device integrations from scratch. | [Deep Dive](tools/vytallink/README.md) |
 | **Python Toolkit** | Python toolkit that can be used as a library to integrate these capabilities into your own applications. | Teams building custom backends, automations, or prototypes on top of VytalLink capabilities. | [GitHub Repo](https://github.com/xmartlabs/vytallink-health-kit) |
 | **Reusable Agent Skills** | Reusable agent skills designed following best practices in UX, accessibility, and interaction design. | Teams that want stronger product decisions, better prompts, and more usable healthcare experiences. | [Deep Dive](skills/) |
 
-## 🔍 Tooling Deep Dive
+## Tooling Deep Dive
 
-### ⌚ Vytallink
+### Vytallink
 Vytallink simplifies the chaos of the wearable ecosystem. Instead of building separate integrations for Apple Health, Garmin Connect, Oura, and others, you integrate with Vytallink once and receive standardized data via API or webhooks.
 
 * **Website:** [vytallink.xmartlabs.com](https://vytallink.xmartlabs.com/)
 * **Implementation Guide:** See [`tools/vytallink`](tools/vytallink)
 
-#### 💡 Ideas to get you started:
+#### Ideas to get you started:
 
 1.  **Personal Health Insights:**
     Connect wearable data (sleep, heart rate, activity) to an LLM to ask natural language questions like "Why was my sleep worse this week?" or "How does my activity affect my resting heart rate?"
 2.  **Personalized Fitness Coaching:**
     Use natural language to get AI-driven recommendations based on wearable data, such as "What workout should I do today based on my recovery and sleep?" or "Am I improving my cardiovascular fitness?".
 
-### 🤖 UX & Accessibility Skills
+### UX & Accessibility Skills
+
+These are reusable AI coding skills for Claude Code, Cursor, Windsurf, or any AI-powered coding tool. Install any skill with a single command:
 
-These are **reusable Claude Code skills** — plug-and-play AI assistants you can drop into your project to get expert-level UX, accessibility, and healthcare design guidance without leaving your editor.
+```bash
+npx skills add https://github.com/xmartlabs/oop-toolkit/tree/main/skills/<skill-name>
+```
 
-> **How to use them:** Copy the `SKILL.md` file from the skill folder into your project and load it into [Claude Code](https://claude.ai/code). The skill will give Claude the knowledge and procedures to assist you at that specific task.
+Each skill gives Claude the context and procedures to help with a specific UX, accessibility, or healthcare design task.
 
 | Skill | What it is | When to use it |
 | :--- | :--- | :--- |
 | **[accessibility-xl](skills/accessibility-xl/SKILL.md)** | Xmartlabs accessibility audit procedure based on WCAG 2.2 Level AA, Core Web Vitals, and UX/UI best practices. | Whenever you need to check contrast ratios, alt text, keyboard navigation, screen reader support, or audit any design for accessibility compliance before handoff. |
 | **[ux-healthcare](skills/ux-healthcare/SKILL.md)** | Expert UX design guide for healthcare digital products, covering compliance (HIPAA, WCAG, ADA), user types, and 10 healthcare-specific design principles. | Anytime you're designing or reviewing a patient portal, clinical tool, health app, telemedicine platform, or any product used by patients, caregivers, or clinicians. |
 | **[ux-prompt-library](skills/ux-prompt-library/SKILL.md)** | UX/UI prompt assistant using the RACE framework for microcopy, wireframe layout, user flows, and UX research — plus a full Figma Make prompting guide. | When you want better outputs from AI tools: writing microcopy, planning wireframes, mapping user flows, writing usability test scripts, or prototyping in Figma Make. |
 
-## 🆘 Support & Resources
+To install all skills at once:
+
+```bash
+npx skills add https://github.com/xmartlabs/oop-toolkit/tree/main/skills
+```
+
+## Support & Resources
 * **Slack:** Join the `#support-xmartlabs` channel for direct technical support from our engineers.
 * **On-Site Mentors:** Look for the **Xmartlabs** t-shirts on the event floor! We are here to help you debug and architect your solutions.
 * **Xmartlabs Website:** [xmartlabs.com](https://xmartlabs.com/)

tools/vytallink/README.md

@@ -16,42 +16,11 @@ Healthcare projects live or die on data. Your wearables might capture blood oxyg
 
 The typical path is painful: parse device outputs, normalize formats across platforms, build ingestion pipelines, wire up an API. That's days of work before you even touch your actual idea.
 
-VytalLink skips all of that. It already speaks Apple Health and Google Fit, exposes your health data through MCP and REST, and integrates natively with Claude and ChatGPT. You plug in and start building the thing that matters.
+VytalLink skips all of that. It already speaks Apple Health and Health Connect, exposes your health data through MCP and REST, and integrates natively with Claude and ChatGPT. You plug in and start building the thing that matters.
 
 ## Quickstart
 
-### Step 1: Get your credentials
-
-1. Install the VytalLink app (iOS / Android)
-2. Connect your health data source (Apple Health or Google Fit)
-3. Tap "Get Word + PIN" in the app — you'll receive a credential pair (e.g. HEALTH7 + sunset42)
-
-▎ The app must stay active while your integration is running. Data streams in real-time from the phone. There's no cloud backend to poll.
-
-### Step 2: Integrate MCP Server
-
-**MCP Server**
-
-Best if you're building an AI agent that supports MCP.
-
-npm install -g @xmartlabs/vytallink-mcp-server
-
-Add to your MCP client config:
-
-{
- "mcpServers": {
-   "vytalLink": {
-     "command": "npx",
-     "args": ["@xmartlabs/vytallink-mcp-server"]
-   }
- }
-}
-
-Restart your client, authenticate with your Word + PIN when prompted, then your AI agent can query health data directly as a tool.
-
-**REST API / WebSocket**
-
-Best if you're building your own backend, dashboard, or real-time monitoring feature. See the API docs for endpoints and authentication flow.
+See the full setup guide at [vytallink.xmartlabs.com/developers.html](https://vytallink.xmartlabs.com/developers.html). It covers integrating the MCP server, linking users via the app, and querying health data in three steps.
 
 ## Practical Example
 
@@ -72,7 +41,7 @@ The AI pulls heart rate and workout data, then produces the comparison — no ma
 | Aspect | Details |
 |--------|---------|
 | **Supported data** | Heart rate, sleep, steps, workouts, wellness trends |
-| **Health sources** | Apple Health, Google Fit |
+| **Health sources** | Apple Health, Health Connect |
 | **AI integrations** | ChatGPT (GPT), Claude Desktop, any MCP client |
 | **Authentication** | Word + PIN (generated in mobile app) |
 | **Protocols** | MCP, REST API, WebSocket, OAuth 2.0 |
@@ -84,14 +53,14 @@ The AI pulls heart rate and workout data, then produces the comparison — no ma
 
 - **App must stay open**: The mobile app needs to remain active during AI conversations — data streams in real-time from the phone
 - **No server-side storage**: Data stays on your device. This is great for privacy but means there's no persistent API you can poll independently — the phone is the data source
-- **Data scope**: Limited to what Apple Health / Google Fit collect. If your wearable doesn't sync to these platforms, VytalLink can't access it
+- **Data scope**: Limited to what Apple Health / Health Connect collect. If your wearable doesn't sync to these platforms, VytalLink can't access it
 - **Healthcare compliance**: This is wellness/fitness data, not clinical-grade medical data. Don't use it for diagnostic purposes
 - **Connectivity**: Requires active internet connection on both phone and desktop
 
 ## Resources
 
 - [VytalLink Website](https://vytallink.xmartlabs.com/)
-- [MCP Setup Guide](https://vytallink.xmartlabs.com/mcp-setup.html)
+- [Developer Setup Guide](https://vytallink.xmartlabs.com/developers.html)
 - [iOS App](https://apps.apple.com/) / [Android App](https://play.google.com/store/apps/details?id=com.xmartlabs.vytallink&hl=en)
 - [Blog: Introducing VytalLink — Making Real Sense of Your Wearable Data](https://blog.xmartlabs.com/blog/vytallink-app/)
 - [Blog: Build a Local Health Data Server on Your Phone with Flutter + MCP](https://blog.xmartlabs.com/blog/blog-building-health-apps-mcp-llms/)