Home / ggg123124 / vrchat-assistant · skills/vrc-monitor-agent/SKILL.md · GitHub

vrc-monitor-agent SKILL.md skillB

vrc-monitor-agent from ggg123124/vrchat-assistant is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it. Use for VRChat friend queries (online status, who played with whom, activity timelines, online patterns) and VRChat social actions (boop, invite, join world, friend management, group operations, image uploads) via the vrc-monitor MCP server on port 8799.

Kind
SKILL.md skill
Repository
ggg123124/vrchat-assistant
Path
skills/vrc-monitor-agent/SKILL.md
Audit grade
B, 16 of 17 checks passed
Versions recorded
13
Latest version
v2.0.0, committed Oct 4, 2026
First version recorded
Sep 8, 2026
Size
38,362 bytes
Repository stars
26
License
MIT

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

# vrc-monitor Agent Skill — 好友监控系统使用指南

本 skill 面向**任何 AI Agent**:当用户询问 VRChat 好友相关问题(谁在线、谁和谁一起玩、某人的活动时间线、上线规律)时,通过 `vrc-monitor` 的 MCP 接口查询。安装配置见项目根 `AGENTS.md` / `README.md`。

> ⚠️ **Agent 义务**:使用中发现本软件代码存在漏洞 / bug(功能异常、数据损坏风险、安全隐患等),应主动提交 issue + PR 修复让所有使用者受益,详见项目根 `AGENTS.md`「发现漏洞 / 缺陷时」小节与 `DEVELOPMENT.md` §1。

- MCP 端点:`http://127.0.0.1:8799/mcp`
- 服务启动:项目目录下 `node start-monitor.js`(首次需配置 `credentials.json`,见 AGENTS.md)
- 数据库:本地 SQLite(WebSocket 实时采集事件,含历史上线/位置/同屏记录)

## MCP 工具

| 工具 | 说明 |
|------|------|
| `get_online_friends` | 当前在线好友列表(含昵称 nickname + 房型解析 locationParsed:worldId/instanceId/type/ownerId/region + 世界名 worldName(未缓存自动 API 补查)+ 房间停留时长 durationMinutes/enteredAt + **在线时长 onlineMinutes/onlineSince**;durationMinutes 进入时间 = max(会话起点, 最新位置事件)防跨会话污染;onlineMinutes = 最近 friend-offline 之后最早 friend-online 起算,重复推送被 MIN 跳过) |
| `get_friend_info` | 好友详细信息 |
| `search_users` | 按名字搜索用户(API 优先;API 无匹配时自动回退本地好友库模糊搜索 display_name/备注,结果带 `source: local_friends` 标记) |
| `search_groups` | 按名字搜索群组(API 用 query 参数,不是 search) |
| `search_worlds` | 按名字搜索世界(英文/日文走 API;中文自动加本地缓存兜底) |
…

Read the whole file at its exact version.

How to install

Latest version
mdr add ggg123124/vrchat-assistant/vrc-monitor-agent@v2.0.0
Exact content
mdr add ggg123124/vrchat-assistant/vrc-monitor-agent@sha256:4123349f80048654

Pin to a label like 1.0.0, or to a sha256 fingerprint for the exact contents. Either way, the exact version is written to mdr.lock. 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_b452xe7mzzjpw6tl.svg)](https://markdownregistry.com/a/art_b452xe7mzzjpw6tl)

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

Versions

The registry has recorded 13 versions of this file, between Sep 8, 2026 and Oct 4, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
v2.0.0 latest2026-10-04 983dd6f 38,362 BB view · diff
v2.0.02026-10-04 69b0b21 38,048 BB view · diff
v2.0.02026-10-03 d558fc4 36,477 BB view · diff
v2.0.02026-10-03 7371a5a 36,171 BB view · diff
v2.0.02026-09-20 d898ff6 35,806 BB view · diff
v2.0.02026-09-20 9437e51 35,742 BB view · diff
v2.0.02026-09-18 b0f9942 34,019 BB view · diff
v2.0.02026-09-18 8c3a413 32,739 BB view · diff
v2.0.02026-09-11 9dfa55a 32,371 BB view · diff
v2.0.02026-09-11 4629bbe 32,195 BB view · diff
v2.0.02026-09-11 b9c6be2 31,805 BB view · diff
v2.0.02026-09-10 ad35238 32,014 BB view · diff
v2.0.02026-09-08 cdd540c 31,624 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:8799)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (38362 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

ggg123124/vrchat-assistant · 26 stars · license MIT · pushed 2026-10-12 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_b452xe7mzzjpw6tl
GET https://markdownregistry.com/api/v1/resolve?ref=ggg123124/vrchat-assistant/vrc-monitor-agent
GET https://markdownregistry.com/api/v1/blob/4123349f80048654f3b03ff41984c6bf707269d28a5772617a78e240cc8f6fb1

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 ggg123124/vrchat-assistant

AGENTS.md AGENTS.md file
ggg123124/vrchat-assistant · AGENTS.md
git:20261011.1ee76c0 · audit B · 26 stars
plugin-template SKILL.md skill
ggg123124/vrchat-assistant · docs/plugin-template/SKILL.md
git:20260913.bb02160 · audit C · 26 stars
auth-guard SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/auth-guard/SKILL.md · 公网访问鉴权与安全防护插件,提供 HTTP Bearer/API-Key 访问拦截、Token 密码学生成与公网就绪度状态评估
git:20260825.70281e5 · audit A · 26 stars
emoji-notes SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/emoji-notes/SKILL.md
git:20260905.9067250 · audit C · 26 stars
events SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/events/SKILL.md · VRChat 社区活动聚合插件:多源采集、群组深度挖掘、音乐/VTuber 筛选、双列时区与中文参加方式标准化输出
git:20261003.bed1832 · audit B · 26 stars
friend-removals SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/friend-removals/SKILL.md
git:20260905.d885067 · audit C · 26 stars
presence-status SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/presence-status/SKILL.md
git:20260923.6bf0534 · audit C · 26 stars
redeem SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/redeem/SKILL.md
git:20260920.d898ff6 · audit C · 26 stars
acceptance-orchestrator SKILL.md skill
ggg123124/vrchat-assistant · skills/acceptance-orchestrator/SKILL.md · Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and…
git:20260831.b03c82e · audit A · 26 stars
address-github-comments SKILL.md skill
ggg123124/vrchat-assistant · skills/address-github-comments/SKILL.md · Use when you need to address review or issue comments on an open GitHub Pull Request using the gh CLI.
git:20260831.b03c82e · audit A · 26 stars
booth-purchase-automation SKILL.md skill
ggg123124/vrchat-assistant · skills/booth-purchase-automation/SKILL.md · Buy a real BOOTH item: search, add to cart, confirm, pay, download via browser CDP.
v1.0.0 · audit A · 26 stars
booth-query-display SKILL.md skill
ggg123124/vrchat-assistant · skills/booth-query-display/SKILL.md · Use when the user asks to search/query BOOTH (booth.pm) items, show BOOTH item rankings, or display BOOTH products with…
v1.0.0 · audit B · 26 stars

Every file in ggg123124/vrchat-assistant

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