vimalinx/bio-agent / .claude/skills/ref-cache
ref-cache
UnverifiedUse when managing local reference sequence caches for htslib-based tools. Invokes the ref-cache CLI to configure or interact with reference cache directories.
ref-cache
ref-cache is an HTSlib reference-caching proxy for CRAM workflows. It serves MD5-addressed reference sequence requests from a local cache, optionally fetching missing sequences from an upstream refget-like service.
Quick Start
- Command:
ref-cache [options] -d <cache_dir> - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/ref-cache - Local help path:
ref-cache -h
When To Use This Tool
- Managing local caches of reference sequences in htslib-based workflows
- Configuring cache directories for reference data access
- Running a local CRAM reference proxy instead of repeatedly hitting a remote server
- Wiring
REF_PATHto a local cache plus HTTP fallback
Common Patterns
# 1) Start a background cache using the EBI upstream service
mkdir -p cached_refs logs
ref-cache -b -d cached_refs -l logs -p 8080 -u https://www.ebi.ac.uk/ena/cram/md5/
# 2) Local-only mode with no upstream fetches
ref-cache -d cached_refs -U -p 8080
# 3) Point HTSlib/SAMtools at the cache
export REF_PATH='/abs/path/cached_refs/%2s/%2s/%s:http:://myhost::8080/%s'
Recommended Workflow
- Create the cache and log directories first.
- Decide whether the service should run in the foreground, as a daemon (
-b), or under systemd socket activation (-s). - Choose whether to allow upstream fetches (
-u) or serve only local files (-U). - After startup, wire the service into CRAM tooling via
REF_PATH.
Guardrails
-d <dir>is mandatory.- This tool uses short options only in local testing.
-hshows help, while--help/--versionwere not validated as safe paths. - The man page says
-band-sare mutually exclusive. - According to the man page,
ref-cacheexits silently if it detects another instance already listening on the chosen port. -Udisables upstream fetches entirely; without it, the default upstream ishttps://www.ebi.ac.uk/ena/cram/md5/.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |