Health logo

Health

CommunityPopular
kellyvv
Health

读取 HealthKit 里的运动、睡眠、心率、体重等健康数据, 在本地生成摘要。只读不写, 数据不离开本机。

Overview

Publisherkellyvv
RepositoryPhoneClaw
Skill nameHealth
Stars
1.3K
Forks
167
Bundled files
2
LicenseApache-2.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 2 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by kellyvv on GitHub. Read the source before you install it.

Installation

Install the Health AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/kellyvv/PhoneClaw.git /tmp/PhoneClaw
mkdir -p .claude/skills
cp -r /tmp/PhoneClaw/Skills/Library/health .claude/skills/Health
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Health in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Health on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Health is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

健康数据查询

你负责读取用户的健康数据并给出简短解读。数据全部在本地处理, 不上传。

工具选择

用户意图工具
今天运动量 / 今天活动量 / 今天运动情况 / 今天锻炼情况health-activity-summary
分析健康数据 / 健康报告 / 健康周报 / 整体健康情况 / 最近N天健康数据health-report (days 按用户时间推断;一周=7,两周=14,一个月=30)
今天/昨天/最近N天步数 / 走了多少步health-query (metric=steps, range=today/yesterday/last_n_days, days 按用户意图传入)
今天走了多远 / 走了多少公里 / 步行距离 / 路程health-query (metric=distance, range=today)
今天消耗了多少卡路里 / 热量 / 千卡health-query (metric=active_energy, range=today)
静息心率health-query (metric=resting_heart_rate, range=recent)
最近心率 / 心跳 / 当前心率health-query (metric=heart_rate, range=recent)
心率变异性 / HRVhealth-query (metric=hrv, range=recent)
体重 / 最近体重health-query (metric=weight, range=latest)
昨晚睡了多久 / 睡眠质量health-query (metric=sleep, range=last_night)
最近一周睡眠health-query (metric=sleep, range=week)
最近运动 / 健身记录health-query (metric=workout, range=recent)

注意: "运动量" / "活动量" / "运动情况" 默认用 health-activity-summary, 不要只查步数。只有用户明确问"走了多少步"才用 health-query(metric=steps)。 注意: "走了多远" / "距离" / "公里" / "米" / "路程" 是距离查询, 必须用 health-query(metric=distance), 不要用 steps。 注意: "健康数据" / "健康报告" / "分析健康" 是综合分析, 必须用 health-report, 不要只查睡眠或步数。只有用户明确说"睡眠"时才用 health-query(metric=sleep)。 注意: 用户在上一轮单项查询后只修正时间范围/天数 (例如"不是 5 天, 是 7 天"), 必须沿用上一轮同一个 metric, 只改 range/days。上一轮是步数就继续用 health-query(metric=steps, range=last_n_days, days=7), 不要升级成 health-report。 首次健康授权会一次请求步数、步行+跑步距离、活动能量、静息心率、睡眠、体能训练、体重、心率、心率变异性读取权限。

时间范围推断

  • "一周" / "本周" / "最近一周" / "7 天" → days=7
  • "两周" / "最近两周" / "14 天" → days=14
  • "一个月" / "最近一个月" / "30 天" → days=30
  • "这几天" 未给具体天数 → days=7
  • days 限制在 1 到 90;不要自己把日期展开成列表, 只传天数

执行流程

  1. 根据用户意图选择正确的工具, 立即调用, 不要追问
  2. 拿到工具结果后, 直接使用返回结果里的自然语言摘要, 不要自己套模板或输出占位符
  3. 综合健康报告 (health-report) 会一次读取该时间范围内所有支持的健康项, 直接使用返回报告
  4. 单项查询 (health-query) 和今天运动概况 (health-activity-summary) 都直接使用返回摘要
  5. 不要自己编造健康数据, 必须用 tool 返回的真实数字
  6. 不要在没调用 tool 之前说"我没有权限"或"我不知道" — 先调工具再说

完成后回复

  • 所有健康数据都用简短自然中文说明, 不要提工具名、JSON 或内部步骤
  • 睡眠、心率、距离、卡路里、运动记录都只说核心数字和一句轻量解读
  • 没有数据时, 直接说明没有可用记录, 不要猜测

权限被拒绝时

如果 tool 返回 failurePayload 且 error 里提到"授权被拒绝"或"设置",告诉用户:

我没能读到健康数据。请去设置 → 隐私与安全性 → 健康 → PhoneClaw, 确认开启相关健康数据读取权限, 然后再问我一次。

不要反复调用 tool 重试。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Health AI skill do?

读取 HealthKit 里的运动、睡眠、心率、体重等健康数据, 在本地生成摘要。只读不写, 数据不离开本机。

Why use Health on TypingMind?

Because you install it once and use it with any model. Health is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Health in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/kellyvv/PhoneClaw/tree/main/Skills/Library/health. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Health?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Health?

As many as you like. As long as a model supports skills, you can use Health with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Health AI skill free?

Yes. It is published on GitHub by kellyvv under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇