Agent Skills
› openai/plugins
› pharmgkb-skill
pharmgkb-skill
GitHub用于向 PharmGKB API 提交紧凑请求，获取基因、变异、临床注释及用药指南的简明摘要。支持通过脚本执行 REST 调用，默认返回 Markdown 总结，也可保存原始数据。
Trigger Scenarios
用户需要查询特定基因的详细信息
用户希望获取变异的临床注释或药物剂量指南
用户要求提供简洁的 PharmGKB 数据汇总
Install
npx skills add openai/plugins --skill pharmgkb-skill -g -y
SKILL.md
Frontmatter
{
"name": "pharmgkb-skill",
"description": "Submit compact PharmGKB API requests for genes, variants, clinical annotations, dosing guidelines, and search. Use when a user wants concise PharmGKB summaries"
}
Operating rules
- Use
scripts/rest_request.pyfor all PharmGKB API calls. - Use
base_url=https://api.pharmgkb.org/v1/data. - Single object lookups usually do not need
max_items; list and search endpoints are better withmax_items=10. - Re-run requests in long conversations instead of relying on older tool output.
- Treat displayed
...in tool previews as UI truncation, not literal request content.
Execution behavior
- Return concise markdown summaries from the script JSON by default.
- Prefer these paths:
gene/<id>,variant/<id>,clinicalAnnotation,dosingGuideline, and search endpoints. - If the user needs the full payload, set
save_raw=trueand report the saved file path.
Input
- Read one JSON object from stdin.
- Required fields:
base_url,path - Optional fields:
method,params,headers,json_body,form_body,record_path,response_format,max_items,max_depth,timeout_sec,save_raw,raw_output_path - Common PharmGKB patterns:
{"base_url":"https://api.pharmgkb.org/v1/data","path":"gene/PA36679"}{"base_url":"https://api.pharmgkb.org/v1/data","path":"clinicalAnnotation","params":{"relatedChemicals.accessionId":"PA449726","limit":10},"max_items":10}{"base_url":"https://api.pharmgkb.org/v1/data","path":"variant/PA166158545"}
Output
- Success returns
ok,source,path,method,status_code,warnings, and either compactrecordsor a compactsummary. - Use
raw_output_pathwhensave_raw=true. - Failure returns
ok=falsewitherror.codeanderror.message.
Execution
echo '{"base_url":"https://api.pharmgkb.org/v1/data","path":"gene/PA36679"}' | python scripts/rest_request.py
References
- No additional runtime references are required; keep the import package limited to this file and
scripts/rest_request.py.
Version History
- 11c74d6 Current 2026-07-19 09:39
