Agent Skills
› openai/plugins
› gnomad-graphql-skill
gnomad-graphql-skill
GitHub封装 gnomAD GraphQL 查询脚本，支持变异频率、基因约束及转录本上下文查询。通过 stdin 接收 JSON 输入，返回简洁的 Markdown 摘要或原始数据，适用于生物信息学数据分析场景。
Trigger Scenarios
查询 gnomAD 数据库中的变异频率
获取基因约束评分
分析转录本后果上下文
Install
npx skills add openai/plugins --skill gnomad-graphql-skill -g -y
SKILL.md
Frontmatter
{
"name": "gnomad-graphql-skill",
"description": "Submit compact gnomAD GraphQL requests for frequency, gene constraint, and variant context queries. Use when a user wants concise gnomAD summaries"
}
Operating rules
- Use
scripts/gnomad_graphql.pyfor all gnomAD GraphQL work. - For nested GraphQL results, start with
max_items=3to5. - Keep selection sets narrow and page or filter at the query level instead of asking for broad dumps.
- Use
query_pathfor long GraphQL documents instead of pasting large inline queries. - Re-run requests in long conversations instead of relying on earlier tool output.
- Treat displayed
...in tool previews as UI truncation, not part of the real query.
Execution behavior
- Return concise markdown summaries from the script JSON by default.
- Return raw JSON only if the user explicitly asks for machine-readable output.
- Prefer targeted queries for variant frequency, gene constraint, or transcript consequence context.
- If the user needs the full payload, set
save_raw=trueand report the saved file path.
Input
- Read one JSON object from stdin.
- Required field:
queryorquery_path - Optional fields:
variables,max_items,max_depth,timeout_sec,save_raw,raw_output_path - Common gnomAD patterns:
{"query":"query { meta { clinvar_release_date } }"}{"query":"query Variant($variantId: String!, $dataset: DatasetId!) { variant(variantId: $variantId, dataset: $dataset) { variantId genome { ac an af } } }","variables":{"variantId":"1-55516888-G-GA","dataset":"gnomad_r4"},"max_items":3}
Output
- Success returns
ok,source,top_keys, a compactsummary, andraw_output_pathwhensave_raw=true. - Failure returns
ok=falsewitherror.codesuch asinvalid_json,invalid_input,network_error,invalid_response, orgraphql_error.
Execution
echo '{"query":"query { meta { clinvar_release_date } }"}' | python scripts/gnomad_graphql.py
References
- No additional runtime references are required; keep the import package limited to this file and
scripts/gnomad_graphql.py.
Version History
- 11c74d6 Current 2026-07-19 09:38
