Agent skill

Bi Semantic Layer Guide

by agentscope-ai in agentscope-ai/QwenPaw-Data

语义层工具使用规范。在发现语义层工具可用、需要查询指标定义/维度信息、验证业务口径、处理指标歧义时,必须优先调用此技能。无语义层工具时不调用。

Apache-2.0Auto-check passed

Install Bi Semantic Layer Guide

skills CLI
$ npx skills add agentscope-ai/QwenPaw-Data --skill bi-semantic-layer-guide -a claude-code

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

GitHub CLI
$ gh skill install agentscope-ai/QwenPaw-Data bi-semantic-layer-guide --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/agentscope-ai/QwenPaw-Data.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/qwenpaw-data-skills/skills/runtime/bi-semantic-layer-guide .claude/skills/bi-semantic-layer-guide && 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
bi-semantic-layer-guide
GitHub stars
124
Token cost
~455 tokens
SKILL.md length
66 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

语义层工具使用规范。在发现语义层工具可用、需要查询指标定义/维度信息、验证业务口径、处理指标歧义时,必须优先调用此技能。无语义层工具时不调用。

  • SKILL.md covers 概述, 可用工具, 查询策略 and 消歧规则
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bi Semantic Layer Guide is an agent skill from agentscope-ai/QwenPaw-Data. 语义层工具使用规范。在发现语义层工具可用、需要查询指标定义/维度信息、验证业务口径、处理指标歧义时,必须优先调用此技能。无语义层工具时不调用。

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

The repository describes itself as: Agentic enterprise data analytics: governed facts (DataBridge), reusable methodology (Skill-Hub), and controllable execution (Host). The licence is Apache-2.0.

Example prompts

  • “/bi-semantic-layer-guide”

What it can do on your machine

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

Bi Semantic Layer Guide loads about 455 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 66 words of instructions outside code blocks.

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

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

The full file from agentscope-ai/QwenPaw-Data at commit e0bae36, republished under its Apache-2.0 licence (© agentscope-ai). 66 words, ~455 tokens.

Download SKILL.mdSave it as .claude/skills/bi-semantic-layer-guide/SKILL.md (or your agent's skills folder).
name
bi-semantic-layer-guide
description
语义层工具使用规范。在发现语义层工具可用、需要查询指标定义/维度信息、验证业务口径、处理指标歧义时,必须优先调用此技能。无语义层工具时不调用。

bi-semantic-layer-guide

概述

语义层是统一管理业务语义元数据的服务,包括指标定义、维度定义、指标维度绑定和数据集映射。


可用工具

语义层暴露三类工具:

  • 全局:list_domains()
  • 指标查询:list_metrics(domain)、search_metrics(query, domain)、get_metric(name, domain)、get_north_star_metrics(domain)
  • 维度查询:list_dimensions(domain)、get_dimension(name, domain)、list_dimensions_of_metric(name, domain)、get_dimension_hierarchy(name, domain)、get_dimension_values(name, domain)
  • 数据集查询:list_datasets(domain)、get_dataset_columns(name, domain)、get_dataset(name, domain)

具体参数和返回格式参见工具自身描述。


查询策略

指标匹配

在语义层中查找指标,可选策略:

  • 语义检索(search_metrics),语义层会自动匹配同义词
  • 查看具体业务域的北极星指标列表(get_north_star_metrics),从中选择最相关的
  • 若以上均未命中,列出该域全部指标(list_metrics),逐一判断和分析条目的相关性。

no_match 必须拦截,不得当作空结果:语义层返回 no_match(或空候选集)表示 该指标在语义层中不存在,与"指标存在但当前无数据"是两件不同的事。

  • 禁止把 no_match 当作 0、空表或"该指标无数据"继续往下分析
  • 禁止绕过语义层自行猜测指标口径、自行拼 SQL 计算一个同名指标
  • 先按上述三条策略换用检索方式重试;仍为 no_match 时,明确向用户说明该指标未在 语义层定义,并请其确认口径或改用已定义的近似指标
  • 报告中不得出现以 no_match 指标为依据的结论
指标属性确认

通过 get_metric 获取指标属性,重点属性:

  • 是否是北极星指标(is_north_star):用于角色分配
  • 是否展示指标(is_display):该指标是否应出现在展示面板中
  • 是否展示分布(is_display_distribution):展示指标时是否同时展示分布图
  • 维度绑定(dimensions):指标可拆解的维度列表,含 is_display_dimension、is_contribution_dimension 标记。
维度信息获取

通过 list_dimensions_of_metric 获取指标可拆解的维度列表(is_contribution_dimension=true 的维度才可用于贡献度拆解),通过 get_dimension_hierarchy 获取维度间的父子层级关系。


消歧规则

搜索指标时可能遇到歧义,按以下规则处理:

  • 匹配到多个指标:优先选北极星指标(is_north_star=true)。若仍有多个候选,结合指标类型和标签综合判断,必要时向用户确认。
  • 精确名称 vs 同义词:若同时出现精确名称匹配和同义词匹配,精确名称优先。例如搜索"DAU",若同时命中指标名为"DAU"的指标和同义词含"DAU"的"访问用户数",取前者。
  • 同名指标跨业务域:若同一指标名出现在多个业务域中,用当前分析任务的业务域限定范围。

© agentscope-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/qwenpaw-data-skills/skills/runtime/bi-semantic-layer-guide of agentscope-ai/QwenPaw-Data.

Open the folder on GitHubat commit e0bae36

Compare with similar skills

Bi Semantic Layer Guide 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.

Bi Semantic Layer Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bi Semantic Layer Guide this skillagentscope-ai/QwenPaw-Data124—~455Automated safety check: PassApache-2.0
Semantic Liststhedaviddias/Front-End-Checklist74k—~504Automated safety check: PassMIT
Semantic Versioningsickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT
Semantic Kernelgithub/awesome-copilot40k1 repos~756Automated safety check: PassMIT
Html5 Semantic Elementsthedaviddias/Front-End-Checklist74k—~449Automated safety check: PassMIT
Bruin Semantic Layerbruin-data/bruin1.8k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Semantic Lists

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use semantic list elements.

    74k GitHub stars~504 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Semantic Versioning

    sickn33/agentic-awesome-skills

    Automate versioning and changelog generation using semantic versioning principles.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed
  • Semantic Kernel

    github/awesome-copilot

    Official

    Create, update, refactor, explain, or review Semantic Kernel solutions using shared guidance plus language-specific references for .NET and Python.

    40k GitHub starsUsed in 1 repo~756 tokens
    DevelopmentAuto-check passed
  • Html5 Semantic Elements

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Use semantic HTML elements.

    74k GitHub stars~449 tokensUpdated 3 days ago
    Auto-check passed
  • Bruin Semantic Layer

    bruin-data/bruin

    A skill your agent uses when creating, editing, reviewing, or troubleshooting Bruin semantic layer models, semantic query CLI usage, metric and dimension definitions, joins, segments, filters…

    1.8k GitHub stars~2.6k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Semantic Versioning

    BagelHole/DevOps-Security-Agent-Skills

    Automate versioning and changelog generation using semantic versioning principles.

    1.1k GitHub stars~2.7k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed

More from agentscope-ai/QwenPaw-Data

All 29 skills in this repo
  • Bi Report Generation

    agentscope-ai/QwenPaw-Data

    将 BI 数据分析结果组织成可视化 HTML 报告。当分析完成、需要生成报告时调用. An agent skill from agentscope-ai/QwenPaw-Data.

    124 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Fetch Data

    agentscope-ai/QwenPaw-Data

    取数 / 查数据 / 拉数据 / 跑 SQL。把自然语言取数需求转为 SQL,经数据湖仓执行后返回查询结果供下游分析。任何需要业务数据的任务在工作区缺少对应文件时都必须先调用此技能——覆盖 BI 业务分析、留存 / 转化 / 同期群分析、数据探索 EDA、统计建模、定量计算、元数据查询、数据查询。命中任一即触发:(1) 直接索要指标或记录,如「DAU 多少」「上月销售额」「3…

    124 GitHub stars~2.5k tokensUpdated 4 days ago
    Auto-check passed
  • Bi Adaptive Threshold

    agentscope-ai/QwenPaw-Data

    通过量化历史数据的自然波动幅度,自适应计算判定阈值。当需要从数据本身确定阈值(如波动阈值、影响度阈值等)、而非使用固定值时调用。仅适用于日/周粒度阈值确定。

    124 GitHub stars~726 tokensUpdated 4 days ago
    Auto-check passed
  • Bi Anomaly Detection

    agentscope-ai/QwenPaw-Data

    基于阈值检测时间序列中的显著异常波动点。当需要找出指标异常波动日期、识别数据异动时调用. An agent skill from agentscope-ai/QwenPaw-Data.

    124 GitHub stars~637 tokensUpdated 4 days ago
    Auto-check passed
  • Bi Attribution Analysis

    agentscope-ai/QwenPaw-Data

    计算各维度(组)值对指标变动的贡献度,支持可加型量值指标和加权平均型/率值指标。当需要计算贡献度、解释指标"为什么涨/跌"时调用。

    124 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Bi Causal Attribution

    agentscope-ai/QwenPaw-Data

    从运营周报、活动文档、对话输入或文档工具 API 中提取业务事件,与指标异常时间窗口对齐,生成有证据支撑的因果归因假设并排序。当已知指标存在异常波动、需要从外部文档证据中解释"为什么"时调用。

    124 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed

Questions about Bi Semantic Layer Guide

What does Bi Semantic Layer Guide do?

语义层工具使用规范。在发现语义层工具可用、需要查询指标定义/维度信息、验证业务口径、处理指标歧义时,必须优先调用此技能。无语义层工具时不调用。. Bi Semantic Layer Guide is an agent skill from agentscope-ai/QwenPaw-Data.

How do I install Bi Semantic Layer Guide in Claude Code?

Run `npx skills add agentscope-ai/QwenPaw-Data --skill bi-semantic-layer-guide -a claude-code`. Or copy the skill folder (packages/qwenpaw-data-skills/skills/runtime/bi-semantic-layer-guide in agentscope-ai/QwenPaw-Data) into .claude/skills/bi-semantic-layer-guide in your project. Claude Code loads it when a task matches its description.

How do I install Bi Semantic Layer Guide in Codex?

Run `npx skills add agentscope-ai/QwenPaw-Data --skill bi-semantic-layer-guide -a codex`. Or copy the skill folder (packages/qwenpaw-data-skills/skills/runtime/bi-semantic-layer-guide in agentscope-ai/QwenPaw-Data) into .agents/skills/bi-semantic-layer-guide in your project. Codex loads it when a task matches its description.

Can I use Bi Semantic Layer Guide 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 agentscope-ai/QwenPaw-Data --skill bi-semantic-layer-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bi-semantic-layer-guide, .gemini/skills/bi-semantic-layer-guide, .github/skills/bi-semantic-layer-guide and .opencode/skills/bi-semantic-layer-guide in your project.

What does Bi Semantic Layer Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Bi Semantic Layer Guide is instructions for the agent only.

Does Bi Semantic Layer Guide 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 Bi Semantic Layer Guide 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 Bi Semantic Layer Guide use?

Bi Semantic Layer Guide is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bi Semantic Layer Guide use?

About 455 tokens (SKILL.md is roughly 1.8k 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 Bi Semantic Layer Guide?

Skills that share tags, products or a category with Bi Semantic Layer Guide: Semantic Lists (thedaviddias/Front-End-Checklist, 74k stars), Semantic Versioning (sickn33/agentic-awesome-skills, 47k stars), Semantic Kernel (github/awesome-copilot, 40k stars) and Html5 Semantic Elements (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bi Semantic Layer Guide?

agentscope-ai (a GitHub organization) maintains it in agentscope-ai/QwenPaw-Data, which has 124 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 5, 2026.

Source: agentscope-ai/QwenPaw-Data on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.