Agent skill

Obdiag Performance

by oceanbase in oceanbase/obdiag

性能类采集与主机 IO:ASH、AWR、perf 火焰图、sysstat、磁盘 IO。在用户说卡顿、慢、会话堆积、要看 ASH/AWR/火焰图或主机负载时使用;与 observer-sql-analysis、observer-log-analysis 互补。

MulanPSL-2.0Auto-check passedDatabases

Install Obdiag Performance

skills CLI
$ npx skills add oceanbase/obdiag --skill obdiag-performance -a claude-code

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

GitHub CLI
$ gh skill install oceanbase/obdiag obdiag-performance --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/oceanbase/obdiag.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/agent/skills/obdiag-performance .claude/skills/obdiag-performance && 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
obdiag-performance
GitHub stars
163
Token cost
~642 tokens
SKILL.md length
161 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MulanPSL-2.0

At a glance

性能类采集与主机 IO:ASH、AWR、perf 火焰图、sysstat、磁盘 IO。在用户说卡顿、慢、会话堆积、要看 ASH/AWR/火焰图或主机负载时使用;与 observer-sql-analysis、observer-log-analysis 互补。

  • Works in 4 steps: gather_ash:设定与现象匹配的时间窗;看等待类、top SQL。 → 若需历史报告包:gather_awr(时间窗与租户/集群参数按环境)。 → 若怀疑主机资源:gather_sysstat;若怀疑磁盘:tool_io_perf… → …
  • Tasks that involve SQL
  • SKILL.md covers 工具选型速查, 与 observer-sql-analysis 的关系, 与日志 skill 的关系 and 调用注意, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Obdiag Performance is an agent skill from oceanbase/obdiag. 性能类采集与主机 IO:ASH、AWR、perf 火焰图、sysstat、磁盘 IO。在用户说卡顿、慢、会话堆积、要看 ASH/AWR/火焰图或主机负载时使用;与 observer-sql-analysis、observer-log-analysis 互补。

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases, covering SQL. It works with SQL. The repository describes itself as: obdiag (OceanBase Diagnostic Tool) is designed to help OceanBase users quickly gather necessary information and analyze the root cause of the problem.

When your agent uses it

  • Tasks that involve SQL

Example prompts

  • “/obdiag-performance”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. gather_ash:设定与现象匹配的时间窗;看等待类、top SQL。
  2. 若需历史报告包:gather_awr(时间窗与租户/集群参数按环境)。
  3. 若怀疑主机资源:gather_sysstat;若怀疑磁盘:tool_io_performance。
  4. 完成标准:已能说明「主要等待/资源瓶颈」或已明确需 observer-sql-analysis / observer-log-analysis 跟进。

What it can do on your machine

Read from SKILL.md and the folder at commit e912c58. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Obdiag Performance loads about 642 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 161 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 (MulanPSL-2.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 161 words (~642 tokens).

name
obdiag-performance

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugins/agent/skills/obdiag-performance of oceanbase/obdiag.

Open the folder on GitHubat commit e912c58

Compare with similar skills

Obdiag Performance 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.

Obdiag Performance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obdiag Performance this skilloceanbase/obdiag163—~642Automated safety check: PassMulanPSL-2.0
Evolving The Data ModelTriliumNext/Trilium38k—~2.1kAutomated safety check: PassAGPL-3.0
Orchardcore Data MigrationOrchardCMS/OrchardCore8.2k—~1.7kAutomated safety check: PassBSD-3-Clause
SQL Optimization Patternsynulihao/AgentSkillOS61711 repos~3.3kAutomated safety check: PassNone
SQL PortabilityHL7/sql-on-fhir150—~512Automated safety check: PassCustom licence
StmoSAP/project-foxhound1802 repos~1.8kAutomated safety check: PassGPL-3.0

Similar skills

  • Evolving The Data Model

    TriliumNext/Trilium

    A skill your agent uses when adding a DB migration or a new column/field to a Becca entity in Trilium ("add a migration", "new column on notes/attributes", "ALTER TABLE", "add a field to…

    38k GitHub stars~2.1k tokensUpdated today
    DatabasesAuto-check passed
  • Orchardcore Data Migration

    OrchardCMS/OrchardCore

    Creates and updates OrchardCore data migrations (DataMigration classes with CreateAsync/UpdateFromX).

    8.2k GitHub stars~1.7k tokensUpdated today
    DatabasesAuto-check passed
  • SQL Optimization Patterns

    ynulihao/AgentSkillOS

    Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries.

    617 GitHub starsUsed in 11 repos~3.3k tokens
    DatabasesAuto-check passed
  • SQL Portability

    HL7/sql-on-fhir

    Analyse whether a SQL query is portable across database implementations using sqlglot transpilation.

    150 GitHub stars~512 tokensUpdated yesterday
    DatabasesAuto-check passed
  • Stmo

    SAP/project-foxhound

    Official

    Manage Redash queries and dashboards on Mozilla's STMO (sql.telemetry.mozilla.org) using stmo-cli.

    180 GitHub starsUsed in 2 repos~1.8k tokens
    DatabasesAuto-check passed
  • DB Migrations

    kurealnum/dotfiles

    A skill your agent uses when generating or regenerating Drizzle migration files, changing database schema tables or columns, resolving migration sequence conflicts after rebase, reviewing migration…

    290 GitHub stars~820 tokensUpdated 5 mo ago
    DatabasesAuto-check passed

More from oceanbase/obdiag

All 14 skills in this repo
  • 备份、日志归档、物理恢复、恢复时间窗、NFS/OSS/COS 归档路径、对象存储权限、备租户恢复源、obadmin 读取归档位点、oblogminer schemameta 等问题;OMS 迁移同步问题不使用本 skill。

    163 GitHub stars~990 tokensUpdated 4 mo ago
    Auto-check passed
  • Obdiag Rca

    oceanbase/obdiag

    OceanBase 集群所有根因分析场景的统一 SOP。覆盖事务超时/回滚/断连、内存不足、合并卡住、日志盘满、DDL 失败、Schema 泄漏、GC 异常、弱一致性读、OMS 等。始终先执行 rcarun,如 RCA 脚本无法给出结论再按本 skill 降级到手动日志采集分析。

    163 GitHub stars~2.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Obdiag Triage

    oceanbase/obdiag

    未知/未分类问题的统一分诊 SOP:用户描述集群异常但症状不明确、不知从何入手,或问题无法直接对应 rca/observer-log-analysis/observer-sql-analysis 等专项 skill 时,强制先执行全量巡检 checkcluster,再根据巡检结果决定下一步路径。

    163 GitHub stars~662 tokensUpdated 4 mo ago
    Auto-check passed
  • Obdiag Usage

    oceanbase/obdiag

    obdiag agent 工具使用指南:配置文件生成、gather/analyze/check/rca 各命令的调用方式、参数说明与典型场景。用户询问"怎么用 obdiag"、"如何采集日志"、"怎么生成配置"、"如何巡检/根因分析",或 agent 自身不确定该调哪个工具时加载本 skill。

    163 GitHub stars~2.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Obproxy Log Analysis

    oceanbase/obdiag

    标准 SOP:OBProxy 日志采集(gatherobproxylog)、包内解读(filelist/fileread/runshell 解压)、可选巡检。用户提到 OBProxy/代理/obproxydiagnosis 等时使用;与 observer 侧 observer-log-analysis 互斥 analyzelog。

    163 GitHub stars~945 tokensUpdated 4 mo ago
    Auto-check passed
  • OBProxy/ODP 连接解析、弱读与只读副本路由、读写分离、分区键解析、SHOW CREATE 兼容、getlock、cluster not exist、2013、Unknown thread id、新建表经代理慢等路由配置类问题;日志采集解读使用 obproxy-log-analysis。

    163 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Obdiag Performance

What does Obdiag Performance do?

性能类采集与主机 IO:ASH、AWR、perf 火焰图、sysstat、磁盘 IO。在用户说卡顿、慢、会话堆积、要看 ASH/AWR/火焰图或主机负载时使用;与 observer-sql-analysis、observer-log-analysis 互补。. Obdiag Performance is an agent skill from oceanbase/obdiag.

When should I use Obdiag Performance?

Obdiag Performance fits situations like: tasks that involve SQL.

How do I install Obdiag Performance in Claude Code?

Run `npx skills add oceanbase/obdiag --skill obdiag-performance -a claude-code`. Or copy the skill folder (plugins/agent/skills/obdiag-performance in oceanbase/obdiag) into .claude/skills/obdiag-performance in your project. Claude Code loads it when a task matches its description.

How do I install Obdiag Performance in Codex?

Run `npx skills add oceanbase/obdiag --skill obdiag-performance -a codex`. Or copy the skill folder (plugins/agent/skills/obdiag-performance in oceanbase/obdiag) into .agents/skills/obdiag-performance in your project. Codex loads it when a task matches its description.

Can I use Obdiag Performance 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 oceanbase/obdiag --skill obdiag-performance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/obdiag-performance, .gemini/skills/obdiag-performance, .github/skills/obdiag-performance and .opencode/skills/obdiag-performance in your project.

What does Obdiag Performance need to run?

SKILL.md names no scripts, command-line tools or credentials: Obdiag Performance is instructions for the agent only.

Does Obdiag Performance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Obdiag Performance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Obdiag Performance use?

Obdiag Performance is published under the MulanPSL-2.0 licence (the repository's licence).

How many tokens does Obdiag Performance use?

About 642 tokens (SKILL.md is roughly 2.6k 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 Obdiag Performance?

Skills that share tags, products or a category with Obdiag Performance: Evolving The Data Model (TriliumNext/Trilium, 38k stars), Orchardcore Data Migration (OrchardCMS/OrchardCore, 8.2k stars), SQL Optimization Patterns (ynulihao/AgentSkillOS, 617 stars) and SQL Portability (HL7/sql-on-fhir, 150 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obdiag Performance?

oceanbase (a GitHub organization) maintains it in oceanbase/obdiag, which has 163 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on May 19, 2026.

Source: oceanbase/obdiag on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.