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…
标准 SOP：单条 SQL 性能、执行计划、trace 计划包、锁等待。用户问「为什么慢」、提供 traceid、或描述锁/超时时使用；与 obdiag-performance（整体 ASH/AWR）、observer-log-analysis（observer 日志链）分工。
Install Observer SQL Analysis
$ npx skills add oceanbase/obdiag --skill observer-sql-analysis -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install oceanbase/obdiag observer-sql-analysis --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/oceanbase/obdiag.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/agent/skills/observer-sql-analysis .claude/skills/observer-sql-analysis && rm -rf skills-srcUse ~/.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/
Install the "observer-sql-analysis" agent skill from https://github.com/oceanbase/obdiag/tree/master/plugins/agent/skills/observer-sql-analysis into .claude/skills/observer-sql-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observer-sql-analysis", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/oceanbase/obdiag/tree/master/plugins/agent/skills/observer-sql-analysisType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add oceanbase/obdiag --skill observer-sql-analysis -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install oceanbase/obdiag observer-sql-analysis --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oceanbase/obdiag.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/agent/skills/observer-sql-analysis .agents/skills/observer-sql-analysis && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "observer-sql-analysis" agent skill from https://github.com/oceanbase/obdiag/tree/master/plugins/agent/skills/observer-sql-analysis into .agents/skills/observer-sql-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observer-sql-analysis", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add oceanbase/obdiag --skill observer-sql-analysis -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install oceanbase/obdiag observer-sql-analysis --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oceanbase/obdiag.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/agent/skills/observer-sql-analysis .cursor/skills/observer-sql-analysis && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "observer-sql-analysis" agent skill from https://github.com/oceanbase/obdiag/tree/master/plugins/agent/skills/observer-sql-analysis into .cursor/skills/observer-sql-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observer-sql-analysis", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/oceanbase/obdiag.git --path plugins/agent/skills/observer-sql-analysis--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add oceanbase/obdiag --skill observer-sql-analysis -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install oceanbase/obdiag observer-sql-analysis --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oceanbase/obdiag.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/agent/skills/observer-sql-analysis .gemini/skills/observer-sql-analysis && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "observer-sql-analysis" agent skill from https://github.com/oceanbase/obdiag/tree/master/plugins/agent/skills/observer-sql-analysis into .gemini/skills/observer-sql-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observer-sql-analysis", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install oceanbase/obdiag observer-sql-analysisInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add oceanbase/obdiag --skill observer-sql-analysis -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/oceanbase/obdiag.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/agent/skills/observer-sql-analysis .github/skills/observer-sql-analysis && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "observer-sql-analysis" agent skill from https://github.com/oceanbase/obdiag/tree/master/plugins/agent/skills/observer-sql-analysis into .github/skills/observer-sql-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observer-sql-analysis", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add oceanbase/obdiag --skill observer-sql-analysis -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install oceanbase/obdiag observer-sql-analysis --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oceanbase/obdiag.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/agent/skills/observer-sql-analysis .opencode/skills/observer-sql-analysis && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "observer-sql-analysis" agent skill from https://github.com/oceanbase/obdiag/tree/master/plugins/agent/skills/observer-sql-analysis into .opencode/skills/observer-sql-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "observer-sql-analysis", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
observer-sql-analysis- GitHub stars
- 163
- Token cost
- ~736 tokens
- SKILL.md length
- 204 words
- Files
- 1
- Skills in repo
- 14
- Repo updated
- First seen
- Licence
- MulanPSL-2.0
At a glance
标准 SOP：单条 SQL 性能、执行计划、trace 计划包、锁等待。用户问「为什么慢」、提供 traceid、或描述锁/超时时使用；与 obdiag-performance（整体 ASH/AWR）、observer-log-analysis（observer 日志链）分工。
- Works in 3 steps: 表格：计划关键指标（操作符、COST、ROWS、索引/分区等）或锁等待关键字段。 → 结论文本：1–3 条 可执行 建议（加索引条件、改写… → 下一步：若需 ASH/AWR、巡检、RCA，指明 skill 或工具。
- Tasks that involve SQL
- SKILL.md covers 触发与边界, 前置条件, 分支：选主路径 and 阶段 A：计划监控包（trace_id）, plus 6 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Observer SQL Analysis is an agent skill from oceanbase/obdiag. 标准 SOP：单条 SQL 性能、执行计划、trace 计划包、锁等待。用户问「为什么慢」、提供 traceid、或描述锁/超时时使用；与 obdiag-performance（整体 ASH/AWR）、observer-log-analysis（observer 日志链）分工。
Its SKILL.md is about 740 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 and Operations and SOPs. 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
- Tasks that involve Operations and SOPs
Example prompts
- “/observer-sql-analysis”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- 表格：计划关键指标（操作符、COST、ROWS、索引/分区等）或锁等待关键字段。
- 结论文本：1–3 条 可执行 建议（加索引条件、改写 SQL、调参、扩时间再采日志等）。
- 下一步：若需 ASH/AWR、巡检、RCA，指明 skill 或工具。
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
Observer SQL Analysis loads about 736 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 204 words of instructions outside code blocks.
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 204 words (~736 tokens).
“目的：拉取与 trace 关联的 SQL plan monitor 材料。”
- name
- observer-sql-analysis
Files
Just SKILL.md in plugins/agent/skills/observer-sql-analysis of oceanbase/obdiag.
Open the folder on GitHubat commit e912c58
Compare with similar skills
Observer SQL Analysis 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Observer SQL Analysis this skilloceanbase/obdiag | 163 | — | ~736 | Automated safety check: Pass | MulanPSL-2.0 | |
| Evolving The Data ModelTriliumNext/Trilium | 38k | — | ~2.1k | Automated safety check: Pass | AGPL-3.0 | |
| SQL Optimization Patternsynulihao/AgentSkillOS | 617 | 10 repos | ~3.3k | Automated safety check: Pass | None | |
| SQL PortabilityHL7/sql-on-fhir | 150 | — | ~512 | Automated safety check: Pass | Custom licence | |
| DB Migrationskurealnum/dotfiles | 290 | — | ~820 | Automated safety check: Pass | None | |
| Contact FilterChatbotXIO/ChatbotX | 878 | — | ~2.5k | Automated safety check: Pass | Custom licence |
Similar skills
SQL Optimization Patterns
ynulihao/AgentSkillOS
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries.
SQL Portability
HL7/sql-on-fhir
Analyse whether a SQL query is portable across database implementations using sqlglot transpilation.
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…
Contact Filter
ChatbotXIO/ChatbotX
Work with the ChatbotX contact filter system — the shared filter model behind the contacts list, conversations, and broadcast audiences.
Add Utils Function
MichealWayne/fe-tools
Add or modify utility functions in fe-tools. An agent skill from MichealWayne/fe-tools.
More from oceanbase/obdiag
All 14 skills in this repoBackup Archive Restore Troubleshooting
oceanbase/obdiag
备份、日志归档、物理恢复、恢复时间窗、NFS/OSS/COS 归档路径、对象存储权限、备租户恢复源、obadmin 读取归档位点、oblogminer schemameta 等问题；OMS 迁移同步问题不使用本 skill。
Obdiag Rca
oceanbase/obdiag
OceanBase 集群所有根因分析场景的统一 SOP。覆盖事务超时/回滚/断连、内存不足、合并卡住、日志盘满、DDL 失败、Schema 泄漏、GC 异常、弱一致性读、OMS 等。始终先执行 rcarun，如 RCA 脚本无法给出结论再按本 skill 降级到手动日志采集分析。
Obdiag Triage
oceanbase/obdiag
未知/未分类问题的统一分诊 SOP：用户描述集群异常但症状不明确、不知从何入手，或问题无法直接对应 rca/observer-log-analysis/observer-sql-analysis 等专项 skill 时，强制先执行全量巡检 checkcluster，再根据巡检结果决定下一步路径。
Obdiag Usage
oceanbase/obdiag
obdiag agent 工具使用指南：配置文件生成、gather/analyze/check/rca 各命令的调用方式、参数说明与典型场景。用户询问"怎么用 obdiag"、"如何采集日志"、"怎么生成配置"、"如何巡检/根因分析"，或 agent 自身不确定该调哪个工具时加载本 skill。
Obproxy Log Analysis
oceanbase/obdiag
标准 SOP：OBProxy 日志采集（gatherobproxylog）、包内解读（filelist/fileread/runshell 解压）、可选巡检。用户提到 OBProxy/代理/obproxydiagnosis 等时使用；与 observer 侧 observer-log-analysis 互斥 analyzelog。
Obproxy Routing Troubleshooting
oceanbase/obdiag
OBProxy/ODP 连接解析、弱读与只读副本路由、读写分离、分区键解析、SHOW CREATE 兼容、getlock、cluster not exist、2013、Unknown thread id、新建表经代理慢等路由配置类问题；日志采集解读使用 obproxy-log-analysis。
Related
Works with
Categories
Questions about Observer SQL Analysis
What does Observer SQL Analysis do?
标准 SOP：单条 SQL 性能、执行计划、trace 计划包、锁等待。用户问「为什么慢」、提供 traceid、或描述锁/超时时使用；与 obdiag-performance（整体 ASH/AWR）、observer-log-analysis（observer 日志链）分工。. Observer SQL Analysis is an agent skill from oceanbase/obdiag.
When should I use Observer SQL Analysis?
Observer SQL Analysis fits situations like: tasks that involve SQL; tasks that involve Operations and SOPs.
How do I install Observer SQL Analysis in Claude Code?
Run `npx skills add oceanbase/obdiag --skill observer-sql-analysis -a claude-code`. Or copy the skill folder (plugins/agent/skills/observer-sql-analysis in oceanbase/obdiag) into .claude/skills/observer-sql-analysis in your project. Claude Code loads it when a task matches its description.
How do I install Observer SQL Analysis in Codex?
Run `npx skills add oceanbase/obdiag --skill observer-sql-analysis -a codex`. Or copy the skill folder (plugins/agent/skills/observer-sql-analysis in oceanbase/obdiag) into .agents/skills/observer-sql-analysis in your project. Codex loads it when a task matches its description.
Can I use Observer SQL Analysis 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 observer-sql-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/observer-sql-analysis, .gemini/skills/observer-sql-analysis, .github/skills/observer-sql-analysis and .opencode/skills/observer-sql-analysis in your project.
What does Observer SQL Analysis need to run?
SKILL.md names no scripts, command-line tools or credentials: Observer SQL Analysis is instructions for the agent only.
Does Observer SQL Analysis 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 Observer SQL Analysis 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 Observer SQL Analysis use?
Observer SQL Analysis is published under the MulanPSL-2.0 licence (the repository's licence).
How many tokens does Observer SQL Analysis use?
About 736 tokens (SKILL.md is roughly 2.9k 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 Observer SQL Analysis?
Skills that share tags, products or a category with Observer SQL Analysis: Evolving The Data Model (TriliumNext/Trilium, 38k stars), SQL Optimization Patterns (ynulihao/AgentSkillOS, 617 stars), SQL Portability (HL7/sql-on-fhir, 150 stars) and DB Migrations (kurealnum/dotfiles, 290 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Observer SQL Analysis?
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.