vital SKILL.md skillB

vital from ximing/vital is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ximing/vital/vital@git:20260930.747d60d

Pins git:20260930.747d60d in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
ximing/vital
Path
skills/vital/SKILL.md
Versions recorded
5
Latest version
git:20260930.747d60d, committed Sep 30, 2026
First version recorded
Sep 9, 2026
Size
4,530 bytes
Repository stars
3
License
none declared

Operate the user's Vital personal OS (today, inbox, tasks, threads, habits, days, lists, tags, reports, search) through its HTTP API. Use when the user asks to add a task, capture a URL, tick a habit, manage threads or 日子, search inbox or reports, write a daily or weekly report, or otherwise manage Vital data. Requires a personal access token from Settings → 令牌. Use when the user runs /vital.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Vital API

Load **one** module from [references/](references/index.md) for the domain you are calling. Do not open every file. Catalog is generated (`pnpm gen:vital-skill`); do not invent fields or paths.

| If you are… | Open |
| --- | --- |
| Today board | [references/today.md](references/today.md) |
| Tasks (list / create / complete) | [references/tasks.md](references/tasks.md); also [lists.md](references/lists.md) when creating |
| Threads | [references/outcomes.md](references/outcomes.md) |
| Inbox capture / read body | [references/inbox.md](references/inbox.md) |
| Habits | [references/habits.md](references/habits.md) |
| Days / 日子 | [references/days.md](references/days.md) |
| Search | [references/search.md](references/search.md) |
| Daily / weekly report | [references/reports.md](references/reports.md) |
| Unknown error `code` | [references/common.md](references/common.md) |
| Anything else | [references/index.md](references/index.md), then that one module |

## Auth

1. If `VITAL_TOKEN` is missing, ask the user to create one in **设置 → 令牌** and paste it (or export the env var). Never ask them to paste their login password.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ximing/vital/vital@sha256:eabe9d7fd45a2817

The line at the top of this page pins the label git:20260930.747d60d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_77pxlgegl2wpdhs4.svg)](https://markdownregistry.com/a/art_77pxlgegl2wpdhs4)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Sep 9, 2026 and Sep 30, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260930.747d60d latest2026-09-30 747d60d 4,530 BB view · diff
git:20260929.ed022382026-09-29 ed02238 4,354 BB view · diff
git:20260920.652c3882026-09-20 652c388 4,086 BB view · diff
git:20260920.ed0719f2026-09-20 ed0719f 3,281 BB view · diff
git:20260909.25f98002026-09-09 25f9800 2,458 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:3010)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4530 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

ximing/vital · 3 stars · license none declared · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_77pxlgegl2wpdhs4
GET https://markdownregistry.com/api/v1/resolve?ref=ximing/vital/vital
GET https://markdownregistry.com/api/v1/blob/eabe9d7fd45a2817e0f1b428ee24496cf703ef0edff2f15c7eb52b7d86d49401

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ximing/vital

ximing-progressive-project SKILL.md skill
ximing/vital · .claude/skills/ximing-progressive-project/SKILL.md · 把现有项目重构为适合 Claude Code 的持久化指令渐进式加载架构。用户提到“拆分根 CLAUDE.md”、“按目录下沉规则”、“给当前项目设计分层指令文件”、“创建不同目录的 CLAUDE.md”、“补…
git:20261021.2674a2a · audit A · 3 stars
AGENTS.md AGENTS.md file
ximing/vital · AGENTS.md
git:20261017.74432da · audit A · 3 stars
CLAUDE.md CLAUDE.md file
ximing/vital · CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
CLAUDE.md@apps/extension CLAUDE.md file
ximing/vital · apps/extension/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
CLAUDE.md@apps/mobile CLAUDE.md file
ximing/vital · apps/mobile/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
CLAUDE.md@apps/server CLAUDE.md file
ximing/vital · apps/server/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars
CLAUDE.md@apps/web CLAUDE.md file
ximing/vital · apps/web/CLAUDE.md
git:20261021.2674a2a · audit A · 3 stars

Every file in ximing/vital

Browse by kind, by grade B, or by owner.