Agent Skills
› openai/plugins
› encode-skill
encode-skill
GitHub用于向 ENCODE REST API 提交紧凑请求，支持对象查找、门户式搜索及元数据检索。通过 stdin 接收 JSON 配置，调用脚本执行并返回简洁的 Markdown 摘要或原始数据，适用于获取简明 ENCODE 信息汇总。
Trigger Scenarios
用户需要查询 ENCODE 数据库中的特定对象（如 biosamples）
用户希望进行基于条件的实验或样本搜索
用户请求获取 ENCODE 项目的元数据或简要总结
Install
npx skills add openai/plugins --skill encode-skill -g -y
SKILL.md
Frontmatter
{
"name": "encode-skill",
"description": "Submit compact ENCODE REST API requests for object lookups, portal-style search, and metadata retrieval. Use when a user wants concise ENCODE summaries"
}
Operating rules
- Use
scripts/rest_request.pyfor all ENCODE API calls. - Use
base_url=https://www.encodeproject.org. - Object lookups usually do not need
max_items; portal-style search endpoints are better withlimit=10andmax_items=10. - Send
Accept: application/jsoninheadersand addformat=jsoninparamswhen needed. - Keep request volume modest and avoid large unfiltered searches.
- 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 accession paths such as
biosamples/<accession>/and search paths such assearch/. - 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 ENCODE patterns:
{"base_url":"https://www.encodeproject.org","path":"biosamples/ENCBS000AAA/","params":{"frame":"object","format":"json"},"headers":{"Accept":"application/json"}}{"base_url":"https://www.encodeproject.org","path":"search/","params":{"type":"Experiment","assay_term_name":"RNA-seq","limit":10,"format":"json"},"record_path":"@graph","headers":{"Accept":"application/json"},"max_items":10}
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://www.encodeproject.org","path":"search/","params":{"type":"Experiment","assay_term_name":"RNA-seq","limit":10,"format":"json"},"record_path":"@graph","headers":{"Accept":"application/json"},"max_items":10}' | 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:38
