Agent skill

Hla Typing

by ClawBio in ClawBio/ClawBio

“HLA allele typing from WGS/WES VCF data”

— description from SKILL.md by ClawBio
MITAuto-check passedResearch & Science

Install Hla Typing

skills CLI
$ npx skills add ClawBio/ClawBio --skill hla-typing -a claude-code

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

GitHub CLI
$ gh skill install ClawBio/ClawBio hla-typing --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/ClawBio/ClawBio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hla-typing .claude/skills/hla-typing && 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
hla-typing
GitHub stars
1.2k
Used in
1 other repo
Token cost
~1.8k tokens
SKILL.md length
605 words
Files
11
Skills in repo
104
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 3 steps: Input validation: Parse and validate… → Analysis: HLA allele typing from WGS/WES… → Reporting: Generate structured markdown…
  • SKILL.md covers Trigger, Why This Exists, Core Capabilities and Scope, plus 15 more sections
  • Runs Python scripts from its folder; calls python

About this skill

Hla Typing is a skill in ClawBio/ClawBio (1.2k stars). Its SKILL.md is about 1.8k tokens, with 10 other files in the folder, and copies of it appear in 1 other owners' repositories. Licence: MIT.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Input validation: Parse and validate input files with format detection
  2. Analysis: HLA allele typing from WGS/WES VCF data
  3. Reporting: Generate structured markdown report with machine-readable JSON

What it can do on your machine

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

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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

Hla Typing loads about 1.8k tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 605 words of instructions outside code blocks.

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

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 ClawBio/ClawBio at commit 5e045e3, republished under its MIT licence (© ClawBio). 605 words, ~1,759 tokens.

Download SKILL.mdSave it as .claude/skills/hla-typing/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
hla-typing
description
HLA allele typing from WGS/WES VCF data
license
MIT
metadata.version
0.1.0
metadata.author
Manuel Corpas
metadata.domain
genomics
metadata.tags
allele, typing, from

Hla Typing

You are Hla Typing, a specialised ClawBio agent for genomics. Your role is to HLA allele genotyping from WGS/WES VCF data.

Trigger

Fire this skill when the user says any of:

  • "HLA allele genotyping from WGS/WES VCF data"
  • "run hla-typing"
  • "allele typing"
  • "HLA haplotype"
  • "determine HLA genotype"

Do NOT fire when:

  • The user asks for general variant annotation (use vcf-annotator)
  • The user asks for pharmacogenomics (use pharmgx-reporter)

Design notes: The trigger must be loud, not subtle. Models skip subdued descriptions. Use exact phrases, domain-specific terms, and multiple synonyms.

Why This Exists

  • Without it: Users must manually perform HLA allele genotyping from WGS/WES VCF data using command-line tools and custom scripts
  • With it: Automated analysis in seconds with a structured, reproducible report
  • Why ClawBio: Grounded in real databases and algorithms, not LLM guessing

Core Capabilities

  1. Input validation: Parse and validate input files with format detection
  2. Analysis: HLA allele typing from WGS/WES VCF data
  3. Reporting: Generate structured markdown report with machine-readable JSON

Scope

One skill, one task. This skill does hla allele typing from wgs/wes vcf data and nothing else.

Input Formats

FormatExtensionRequired FieldsExample
VCF.vcfCHROM, POS, REF, ALT, GTdemo_input.txt
TSV.tsvvariant columnssample.tsv

Workflow

When the user asks for HLA typing:

  1. Validate: Check input format and required fields
  2. Parse: Extract relevant variants and annotations
  3. Analyze: Apply HLA typing algorithm
  4. Generate: Write result.json with structured findings
  5. Report: Write report.md with findings, tables, and disclaimer

Freedom level guidance:

  • For database lookups and variant classification: be prescriptive. Every step must be exact.
  • For report narrative and interpretation: give guidance but leave room for reasoning.

CLI Reference

bash
# Standard usage
python skills/hla-typing/hla_typing.py \
  --input <input_file> --output <report_dir>

# Demo mode (synthetic data, no user files needed)
python skills/hla-typing/hla_typing.py --demo --output /tmp/hla_typing_demo

# Via ClawBio runner
python clawbio.py run hla-typing --input <file> --output <dir>
python clawbio.py run hla-typing --demo

Demo

To verify the skill works:

bash
python clawbio.py run hla-typing --demo

Expected output: a report covering synthetic input data with structured results.

Algorithm / Methodology

  1. Parse input: Read VCF/TSV and extract relevant loci
  2. Lookup: Query reference databases for annotations
  3. Score: Apply scoring algorithm to classify findings
  4. Report: Generate structured output

Key thresholds / parameters:

  • TODO: define thresholds with citations

Example Queries

  • "HLA allele typing from WGS/WES VCF data"
  • "run hla-typing on my VCF"
  • "analyze my sample with hla-typing"

Example Output

markdown
# Hla Typing Report

**Input**: demo_input.txt (5 variants)
**Date**: 2026-04-06

| Locus | Finding | Confidence |
|-------|---------|------------|
| chr6:29942470 | Example finding 1 | High |
| chr6:31353872 | Example finding 2 | Medium |

## Summary
Analysis completed on 5 variants. 2 findings reported.

*ClawBio is a research and educational tool. It is not a medical device and does not provide clinical diagnoses. Consult a healthcare professional before making any medical decisions.*

Output Structure

output_directory/
├── report.md              # Primary markdown report
├── result.json            # Machine-readable results
├── tables/
│   └── results.csv        # Tabular data
└── reproducibility/
    ├── commands.sh         # Exact commands to reproduce
    └── environment.yml     # Environment snapshot
Show full SKILL.md (248 more words)Show less

Dependencies

Required:

  • pandas >= 2.0; data manipulation

Optional:

  • biopython; sequence handling (graceful degradation without it)

Gotchas

  • Gotcha 1: The model tends to infer results from gene names alone. Instead, always require actual genotype data from the input file. Why: inferred results are unreliable and clinically dangerous.
  • Gotcha 2: When input contains multi-allelic sites, the model will attempt to split them. The correct approach is to process them as-is and flag complexity in the report.
  • Gotcha 3: Empty or malformed VCF lines cause silent failures. Always validate each record before processing and log skipped lines to stderr.

Safety

  • Local-first: No data upload without explicit consent
  • Disclaimer: Every report includes: "ClawBio is a research and educational tool. It is not a medical device and does not provide clinical diagnoses. Consult a healthcare professional before making any medical decisions."
  • Audit trail: Log all operations to reproducibility bundle
  • No hallucinated science: All parameters trace to cited databases

Agent Boundary

The agent (LLM) dispatches and explains. The skill (Python) executes. The agent must NOT override thresholds or invent associations.

Integration with Bio Orchestrator

Trigger conditions: the orchestrator routes here when:

  • User mentions allele or hla-typing
  • Input file contains relevant loci

Chaining partners: this skill connects with:

  • pharmgx-reporter: downstream pharmacogenomic implications
  • profile-report: feeds into unified patient profile

Maintenance

  • Review cadence: Re-evaluate monthly or when upstream databases update
  • Staleness signals: new reference database release, API endpoint change
  • Deprecation: If superseded by a more comprehensive skill, archive to skills/_deprecated/

Citations

  • TODO: Add relevant database and paper citations

© ClawBio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 10 other files in skills/hla-typing of ClawBio/ClawBio.

  • SKILL.md
  • api.py
  • bench_test_cases/ht_01_basic_correct/ground_truth.txt
  • bench_test_cases/ht_01_basic_correct/input.txt
  • bench_test_cases/ht_02_empty_input/ground_truth.txt
  • bench_test_cases/ht_02_empty_input/input.txt
  • bench_test_cases/ht_03_malformed_input/ground_truth.txt
  • bench_test_cases/ht_03_malformed_input/input.txt
  • demo_input.txt
  • hla_typing.py
  • tests/test_hla_typing.py

Open the folder on GitHubat commit 5e045e3

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ClawBio/ClawBio, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hla Typing 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.

Hla Typing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hla Typing this skillClawBio/ClawBio1.2k1 repos~1.8kAutomated safety check: PassMIT
Hypothesis Generationspacering-net/codeg3.8k15 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow83k5 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills46k2 repos~2.1kAutomated safety check: PassApache-2.0
Read arXiv Paperkarpathy/nanochat58k2 repos~494Automated safety check: PassMIT
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.8k GitHub starsUsed in 15 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    83k GitHub starsUsed in 5 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    46k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    58k GitHub starsUsed in 2 repos~494 tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.8k GitHub starsUsed in 18 repos~5.9k tokens
    Research & ScienceAuto-check: notes

More from ClawBio/ClawBio

All 104 skills in this repo
  • Fetch a region of cis-eQTL summary statistics from EBI eQTL Catalogue v7+ via tabix-on-FTP.

    1.2k GitHub starsUsed in 1 repo~4.3k tokens
    Auto-check passed
  • Xena Tcga Gene Query

    ClawBio/ClawBio

    Query TCGA tumor biology through the ucscxenatoolspy API. An agent skill from ClawBio/ClawBio.

    1.2k GitHub stars~4.7k tokensUpdated yesterday
    Auto-check passed
  • Fetch a region of GWAS summary statistics from the NHGRI-EBI GWAS Catalog harmonised collection via tabix-on-FTP.

    1.2k GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check passed
  • Dnasp

    ClawBio/ClawBio

    Population genetics of pre-aligned DNA sequences or multi-sample VCFs using selected DnaSP 6 methods.

    1.2k GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed
  • Compute pairwise r² between a lead variant and every variant in a window using the 1000 Genomes Phase 3 GRCh38 reference panel, ancestry-stratified.

    1.2k GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed
  • Ncbi Datasets

    ClawBio/ClawBio

    Download genomes, genes, virus sequences, and taxonomy data from NCBI using the datasets and dataformat CLI tools.

    1.2k GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check passed

Questions about Hla Typing

How do I install Hla Typing in Claude Code?

Run `npx skills add ClawBio/ClawBio --skill hla-typing -a claude-code`. Or copy the skill folder (skills/hla-typing in ClawBio/ClawBio) into .claude/skills/hla-typing in your project. Claude Code loads it when a task matches its description.

How do I install Hla Typing in Codex?

Run `npx skills add ClawBio/ClawBio --skill hla-typing -a codex`. Or copy the skill folder (skills/hla-typing in ClawBio/ClawBio) into .agents/skills/hla-typing in your project. Codex loads it when a task matches its description.

Can I use Hla Typing 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 ClawBio/ClawBio --skill hla-typing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hla-typing, .gemini/skills/hla-typing, .github/skills/hla-typing and .opencode/skills/hla-typing in your project.

What does Hla Typing need to run?

Going by SKILL.md and its folder, Hla Typing needs Python for the scripts in its folder and the command-line tools its instructions call (python).

Does Hla Typing 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 Hla Typing 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 Hla Typing use?

Hla Typing is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hla Typing use?

About 1.8k tokens (SKILL.md is roughly 7k 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 Hla Typing?

Skills that share tags, products or a category with Hla Typing: Hypothesis Generation (spacering-net/codeg, 3.8k stars), GitHub Deep Research (bytedance/deer-flow, 83k stars), Nature Paper Card (Yuan1z0825/nature-skills, 46k stars) and Read arXiv Paper (karpathy/nanochat, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hla Typing?

ClawBio (a GitHub organization) maintains it in ClawBio/ClawBio, which has 1,154 GitHub stars. The repository holds 104 skills in this directory. The repository was last updated on October 7, 2026.

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