Agent skill

Diagnose Cloud Session

by FreakStudioCN in FreakStudioCN/mpy-hardware-extension

用户报告 Blockless 扩展在云端实测时出问题(卡死/灰屏/跳步/构建失败),但本地复现不了、日志不在本地文件里时,用这个从云端托管数据库拉真实 session 定位症状与根因 / Use when a user reports an in-product Blockless bug from live cloud-backend testing and the real session…

Custom licenceAuto-check: notesDatabases

Install Diagnose Cloud Session

skills CLI
$ npx skills add FreakStudioCN/mpy-hardware-extension --skill diagnose-cloud-session -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install FreakStudioCN/mpy-hardware-extension diagnose-cloud-session --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/FreakStudioCN/mpy-hardware-extension.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/diagnose-cloud-session .claude/skills/diagnose-cloud-session && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
diagnose-cloud-session
GitHub stars
132
Token cost
~809 tokens
SKILL.md length
178 words
Files
3
Skills in repo
8
Repo updated
First seen
Licence
Custom licence

At a glance

用户报告 Blockless 扩展在云端实测时出问题(卡死/灰屏/跳步/构建失败),但本地复现不了、日志不在本地文件里时,用这个从云端托管数据库拉真实 session 定位症状与根因 / Use when a user reports an in-product Blockless bug from live cloud-backend testing and the real session…

  • Not in local files
  • SKILL.md covers 凭据(只读,绝不写生产库), 步骤, 判读语义(踩过的坑,最值钱的部分) and ⚠️ 覆盖缺口:数据库对 UI/阶段 bug 是瞎的, plus 1 more section
  • Runs Python scripts from its folder; calls python and curl; reaches blockless.upypi.net; needs MPYHW_ADMIN_TOKEN
  • Session 卡死/awaitinguser

What it does

Diagnose Cloud Session is an agent skill from FreakStudioCN/mpy-hardware-extension. 用户报告 Blockless 扩展在云端实测时出问题(卡死/灰屏/跳步/构建失败),但本地复现不了、日志不在本地文件里时,用这个从云端托管数据库拉真实 session 定位症状与根因 / Use when a user reports an in-product Blockless bug from live cloud-backend testing and the real session data lives in the hosted Postgres (telemetryevents / llmturns / sessions), not in local files. Triggers — "查数据库找症状", "去看真实log", session 卡死/awaitinguser, 搜索驱动卡住, 审批卡片灰屏, repairexhausted, 只能靠 traceid / admin 接口排障.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `db_events.py` and `db_query.py`).

It sits in Databases. It works with PostgreSQL.

When your agent uses it

  • Not in local files
  • Session 卡死/awaitinguser
  • Repairexhausted
  • 只能靠 traceid / admin 接口排障

Example prompts

  • “查数据库找症状”
  • “去看真实log”
  • “/diagnose-cloud-session”

Requirements

  • Python 3
  • Docker
  • A credential in MPYHW_ADMIN_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit b661df6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • blockless.upypi.net

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MPYHW_ADMIN_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Diagnose Cloud Session loads about 809 tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 178 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~809

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:13
    在仓库**(也不在任何提交进 git 的部署配置里)。本地 `mpyhw-api/.env` 的 `DATABASE_URL` 是本地 docker 库(127.0.0.1:55432),**不是这个**。从托管数据库控制台复制生产库的 E
  • NoteMentions a .env fileSKILL.md:22
    python <skill>/db_query.py .env PROD_DATABASE_URL
  • NoteMentions a .env fileSKILL.md:24
    python <skill>/db_events.py .env PROD_DATABASE_URL <trace_id> [<trace_id> ...]
  • NoteMentions a .env fileSKILL.md:28
    t/v1/admin/sessions/<trace_id>`(token 在 `.env`;与生产不一致就找维护者要生产值)。

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 178 words (~809 tokens).

“线上实测(扩展连 https://blockless.upypi.net)的 session 事件经 CloudTelemetryRecorder 进了云端托管 Postgres(blockless-db),不在本地。排障入口是这个库的 sessions / telemetry_events / llm_turns 三张表(schema 见 mpyhw-api/app/db.py)。”

— opening of SKILL.md by FreakStudioCN, Custom licence
name
diagnose-cloud-session
argument-hint
[N most-recent | trace-id]

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in .claude/skills/diagnose-cloud-session of FreakStudioCN/mpy-hardware-extension.

  • SKILL.md
  • db_events.py
  • db_query.py

Open the folder on GitHubat commit b661df6

Compare with similar skills

Diagnose Cloud Session next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Diagnose Cloud Session compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Diagnose Cloud Session this skillFreakStudioCN/mpy-hardware-extension132—~809Automated safety check: NotesCustom licence
Backend Test WorkerCorrectRoadH/OpenTickly306—~1.3kAutomated safety check: PassAGPL-3.0
Ef Core Migrationsjihadkhawaja/Egroo178—~673Automated safety check: PassApache-2.0
Add Oliphaunt Extensionf0rr0/oliphaunt105—~1.4kAutomated safety check: PassMIT
DB AdminEliasOulkadi/shokunin114—~2kAutomated safety check: NotesMIT
Postgresql Table Designynulihao/AgentSkillOS61715 repos~4kAutomated safety check: PassNone

Similar skills

  • Backend Test Worker

    CorrectRoadH/OpenTickly

    Build and verify real-Postgres Go tests and thin transport smoke for tracking behavior.

    306 GitHub stars~1.3k tokensUpdated 6 days ago
    DatabasesAuto-check passed
  • Ef Core Migrations

    jihadkhawaja/Egroo

    Handle EF Core schema changes in Egroo. An agent skill from jihadkhawaja/Egroo.

    178 GitHub stars~673 tokensUpdated 6 mo ago
    DatabasesAuto-check passed
  • Add, update, or remove an Oliphaunt PostgreSQL contrib or external extension, including source pins, build recipes, target support, SDK metadata, release products, carrier identities, and package…

    105 GitHub stars~1.4k tokensUpdated today
    DatabasesAuto-check passed
  • DB Admin

    EliasOulkadi/shokunin

    PostgreSQL database administration — backup/restore (pgdump, PITR, WAL archiving), health monitoring (connections, bloat, cache hit ratio, dead tuples), connection pooling (PgBouncer), replication…

    114 GitHub stars~2k tokensUpdated 3 days ago
    DatabasesAuto-check: notes
  • Postgresql Table Design

    ynulihao/AgentSkillOS

    Design a PostgreSQL-specific schema. An agent skill from ynulihao/AgentSkillOS.

    617 GitHub starsUsed in 15 repos~4k tokens
    DatabasesAuto-check passed
  • Postgres Patterns

    ThibautBaissac/rails_ai_agents

    PostgreSQL database patterns for query optimization, schema design, indexing, and security.

    665 GitHub starsUsed in 7 repos~922 tokens
    DatabasesAuto-check passed

More from FreakStudioCN/mpy-hardware-extension

All 8 skills in this repo
  • Blockless Extension E2E

    FreakStudioCN/mpy-hardware-extension

    Run and debug the Blockless VS Code extension release gate: CI-equivalent API and extension tests, V0 protocol smoke, live DeepSeek full-stack e2e, VSIX packaging, local reinstall, direct…

    132 GitHub stars~1.2k tokensUpdated 10 days ago
    Auto-check: notes
  • Review PR

    FreakStudioCN/mpy-hardware-extension

    A skill your agent uses when reviewing the open pull requests in this repo (mpy-hardware-extension / blockless extension) — "review the PRs", "review PRs with codex", triaging open PRs, gating PRs…

    132 GitHub stars~869 tokensUpdated 10 days ago
    Auto-check passed
  • Cloud Test

    FreakStudioCN/mpy-hardware-extension

    用本地前端插件连云端后端做端到端测试 / test the local VS Code extension against the deployed cloud backend.

    132 GitHub stars~1.7k tokensUpdated 10 days ago
    Auto-check passed
  • Dev Up

    FreakStudioCN/mpy-hardware-extension

    启动 Blockless 本地开发栈 / bring up the local dev stack. An agent skill from FreakStudioCN/mpy-hardware-extension.

    132 GitHub stars~1.3k tokensUpdated 10 days ago
    Auto-check: notes
  • Publish Extension

    FreakStudioCN/mpy-hardware-extension

    发布 Blockless VS Code 扩展到 Visual Studio Marketplace(含发布前测试)/ ship the Blockless extension to the VS Code Marketplace.

    132 GitHub stars~1.3k tokensUpdated 10 days ago
    Auto-check passed
  • Publish Extension

    FreakStudioCN/mpy-hardware-extension

    发布 Blockless VS Code 扩展的预检 + MS Marketplace 那一半 / preflight and the MS Marketplace half of shipping the Blockless extension.

    132 GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check passed

Works with

Categories

Questions about Diagnose Cloud Session

What does Diagnose Cloud Session do?

用户报告 Blockless 扩展在云端实测时出问题(卡死/灰屏/跳步/构建失败),但本地复现不了、日志不在本地文件里时,用这个从云端托管数据库拉真实 session 定位症状与根因 / Use when a user reports an in-product Blockless bug from live cloud-backend testing and the real session…. Diagnose Cloud Session is an agent skill from FreakStudioCN/mpy-hardware-extension. 用户报告 Blockless 扩展在云端实测时出问题(卡死/灰屏/跳步/构建失败),但本地复现不了、日志不在本地文件里时,用这个从云端托管数据库拉真实 session 定位症状与根因 / Use when a user reports an in-product Blockless bug from live cloud-backend testing and the real session data lives in the hosted Postgres (telemetryevents / llmturns / sessions), not in local files.

When should I use Diagnose Cloud Session?

Diagnose Cloud Session fits situations like: not in local files; session 卡死/awaitinguser; repairexhausted; 只能靠 traceid / admin 接口排障.

How do I install Diagnose Cloud Session in Claude Code?

Run `npx skills add FreakStudioCN/mpy-hardware-extension --skill diagnose-cloud-session -a claude-code`. Or copy the skill folder (.claude/skills/diagnose-cloud-session in FreakStudioCN/mpy-hardware-extension) into .claude/skills/diagnose-cloud-session in your project. Claude Code loads it when a task matches its description.

How do I install Diagnose Cloud Session in Codex?

Run `npx skills add FreakStudioCN/mpy-hardware-extension --skill diagnose-cloud-session -a codex`. Or copy the skill folder (.claude/skills/diagnose-cloud-session in FreakStudioCN/mpy-hardware-extension) into .agents/skills/diagnose-cloud-session in your project. Codex loads it when a task matches its description.

Can I use Diagnose Cloud Session in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add FreakStudioCN/mpy-hardware-extension --skill diagnose-cloud-session -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/diagnose-cloud-session, .gemini/skills/diagnose-cloud-session, .github/skills/diagnose-cloud-session and .opencode/skills/diagnose-cloud-session in your project.

What does Diagnose Cloud Session need to run?

Going by SKILL.md and its folder, Diagnose Cloud Session needs Python for the scripts in its folder, the command-line tools its instructions call (python and curl) and credentials named MPYHW_ADMIN_TOKEN. Our summary lists: Python 3; Docker; A credential in MPYHW_ADMIN_TOKEN.

Does Diagnose Cloud Session access the network?

SKILL.md names 1 domain. In commands or code: blockless.upypi.net; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Diagnose Cloud Session safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Diagnose Cloud Session use?

Diagnose Cloud Session has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Diagnose Cloud Session use?

About 809 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Diagnose Cloud Session?

Skills that share tags, products or a category with Diagnose Cloud Session: Backend Test Worker (CorrectRoadH/OpenTickly, 306 stars), Ef Core Migrations (jihadkhawaja/Egroo, 178 stars), Add Oliphaunt Extension (f0rr0/oliphaunt, 105 stars) and DB Admin (EliasOulkadi/shokunin, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Diagnose Cloud Session?

FreakStudioCN (a GitHub organization) maintains it in FreakStudioCN/mpy-hardware-extension, which has 132 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 28, 2026.

Source: FreakStudioCN/mpy-hardware-extension on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.