unibind-database
/unibind-database
Queries the UniBind database for experimentally validated transcription factor (TF) binding sites. Use when retrieving direct TF-DNA interaction datasets, downloading binding site coordinates (BED/FASTA) for local analysis, or listing available datasets by species, cell line, or TF name. Don't use to query specific intervals, locations, genes, motif models or expression data.
- Author
- ekko8600 ↗
- Repository
- enzyme_design_harness ↗
- Licence
- Apache-2.0
- Last repository change
- 08.11.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 08.11.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/unibind_api.py
What it does and when to use it
Queries the UniBind database for experimentally validated transcription factor (TF) binding sites. Use when retrieving direct TF-DNA interaction datasets, downloading binding site coordinates (BED/FASTA) for local analysis, or listing available datasets by species, cell line, or TF name. Don't use to query specific intervals, locations, genes, motif models or expression data.
Original author description
Queries the UniBind database for experimentally validated transcription factor (TF) binding sites. Use when retrieving direct TF-DNA interaction datasets, downloading binding site coordinates (BED/FASTA) for local analysis, or listing available datasets by species, cell line, or TF name. Don't use to query specific intervals, locations, genes, motif models or expression data.
How it works
- Prerequisites
- Quick Start
- Core Rules
- Utility Scripts
- Anti-Patterns
SKILL.md preview
---
name: unibind-database
description: Queries the UniBind database for experimentally validated transcription
factor (TF) binding sites. Use when retrieving direct TF-DNA interaction datasets,
downloading binding site coordinates (BED/FASTA) for local analysis, or listing
available datasets by species, cell line, or TF name. Don't use to query specific
intervals, locations, genes, motif models or expression data.
metadata:
category: data
legacy_category: databases
taxonomy_version: enzyme-agent/taxonomy/v1
capability_ids:
- data.scientific_database.retrieval
---
# UniBind Database Skill
UniBind is a database of direct TF–DNA interactions across 9 species,
integrating ChIP-seq peaks with JASPAR TF binding profiles via the DAMO
framework.
## Prerequisites
1. **Python**: Run scripts directly with `python`; do not require `uv` unless the script explicitly fails without it.
2. **User Notification**: If LICENSE_NOTIFICATION.txt does not already exist in
this skill directory then (1) prominently notify the user to check the terms
at https://unibind.uio.no/ and https://unibind.uio.no/api/overview, then (2)
create the file recording the notification text and timestamp.
## Quick Start
Query commands print JSON to stdout by default. Most outputs are small enough to
read directly. For large outputs (`list_cell_lines`, `list_tfs`), pipe through
`jq` to extract only the fields you need.
```bash
python <SKILL DIR>/scripts/unibind_api.py list_species
```
The `download_tfbs` command writes BED/FASTA files to `--output-dir` instead.
You may optionally use `--output <path>` on any query command to save results to
a file if needed.
## Core Rules
- **Use the Wrapper**: ALWAYS execute the provided helper scripts to query the
database rather than accessing the database directly. The scripts
automatically enforce the required rate limit gracefully.
- **Output**: Query commands print JSON to stdout. Most responses are compact
and can be read directly.
- **Large Results**: `list_cell_lines` and `list_tfs` produce large output.
Pipe these through `jq` to extract specific fields rather than reading the
full output into context.
- **Saving to File**: Use `--output <path>` when you need to reference the
data later or when processing very large results with `jq`.
- **Pagination**: Use `--page` and `--page-size` (max 1000) to chunk large
result sets.
- **Ordering**: Use `--order field_name` (prefix with `-` for descending) on
any list command.
- **Notification**: If this skill is used, ensure this is mentioned in the
output.
## Utility Scripts
*Replace `<SKILL DIR>` with the absolute path to this skill's directory.*
### 1. List Species
```bash
python <SKILL DIR>/scripts/unibind_api.py list_species
```
### 2. List Collections
```bash
python <SKILL DIR>/scripts/unibind_api.py list_collections
```
### 3. List Cell Lines & TFs (large output — use `jp`)
These commands return large datasets. Use `uvx --from jmespath jp` to extract
only the fields you need.
```bash
python <SKILL DIR>/scripts/unibind_api.py list_cell_lines | uvx --from jmespath jp "results[].name"
python <SKILL DIR>/scripts/unibind_api.py list_tfs | uvx --from jmespath jp "results[].tf_name"
```
### 4. List and Filter Datasets (and Profile-Specific Datasets)
Filter datasets using the following arguments:
- `--species` (e.g., "Homo sapiens")
- `--tf-name` (e.g., "CTCF")
- `--cell-line` (e.g., "mESC")
- `--collection` (e.g., Permissive, Robust)
- `--search` (a search term)
- `--biological-condition` (biological condition or source)
- `--data-source` (source of data, e.g., "ENCODE")
- `--has-pvalue` ("true" or "false")
- `--identifier` (e.g., "GSE60130")
- `--jaspar-id` (JASPAR database profile matrix ID)
- `--model` (prediction model)
- `--summary` (summary filter)
- `--threshold-pvalue` (p-value threshold)
Use `list_datasets` for standard datasets, or `list_specific_datasets` for
profile-specific queries.
```bash
python <SKILL DIR>/scripts/unibind_api.py list_datasets --species "Homo sapiens" --tf-name "CTCF" --data-source "ENCODE"
python <SKILL DIR>/scripts/unibind_api.py list_specific_datasets --species "Mus musculus" --cell-line "mESC"
```
### 5. Get Dataset Details
```bash
python <SKILL DIR>/scripts/unibind_api.py get_dataset "EXP047889.HMLE-Twist-ER_breast_cancer.SMAD3"
```
### 6. Download TFBS Files (BED / FASTA)
Downloads all TFBS files for a dataset to a local directory. Use `--format bed`
(default) or `--format fasta`.
```bash
python <SKILL DIR>/scripts/unibind_api.py download_tfbs "EXP047889.HMLE-Twist-ER_breast_cancer.SMAD3" --output-dir /tmp/tfbs --format bed
```
## Anti-Patterns
- **DON'T** attempt to use the UniBind API to query specific genomic
intervals, locations, or genes.
- **DON'T** guess or hallucinate genome coordinates. Always use
`ensembl-database` as an external check if you're pulling local BED tracks
for offline bedtools intersection.
- **DON'T** use for motif models (PFMs). Use the **jaspar-database** skill
instead.
- **DON'T** use for gene expression data. UniBind only stores binding events.
- **DON'T** assume tissue-specific expression from dataset lists alone.
- **DON'T** use `cat` to read large JSON output files into context. The output
is too large. Use `jq` or write your own code to parse the output files.
Files in this package (5)
- SKILL.md 5 KB
- execution_profile.json 1 KB
- scientific_contract.yaml 1 KB
- agents/openai.yaml 1 KB
- scripts/unibind_api.py 13 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · ekko8600/enzyme_design_harness | 100 | Apache-2.0 |
| google-deepmind/science-skills | 95 | Apache-2.0 |
| mkurman/zorai | 95 | MIT |
Database snapshot: 13.11.2026 · package version 2588324e1bd1 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100alterlab-jaspar
Query JASPAR for transcription factor binding site (TFBS) profiles (PWMs/PFMs), searching by TF name, species, or class, scanning DNA sequences for binding sites, and comparing matrices. Use when doing motif analysis, regulatory genomics, transcription factor binding prediction,… - 100tooluniverse-regulatory-genomics
Transcription factor binding, cis-regulatory elements (cCREs), chromatin accessibility, and regulatory annotation using JASPAR (motifs), UniBind, ENCODE (cCREs, ChIP-seq), RegulomeDB (regulatory variant scoring), UCSC, and the Ensembl Regulatory Build (motif instances,… - 95bio-motif-search
Find sequence motifs, degenerate IUPAC patterns, and transcription-factor binding sites in DNA/RNA using Biopython and regex, including position weight matrix (PWM/PSSM) scoring. Use when locating regulatory elements, counting overlapping motif occurrences, scanning for… - 93jaspar-database
JASPAR 2024 TF binding profiles via REST API and pyJASPAR. Retrieve PFMs/PWMs by TF name, JASPAR ID, species, or structural class. Scan DNA for TFBS; browse by taxon (human, mouse) or TF family (bHLH, zinc finger). Use for motif enrichment input, TFBS scanning, and regulatory… - 93remap-database
Query ReMap 2022 TF ChIP-seq peak database via REST API and BED downloads. Retrieve TF peaks overlapping a region (chr:start-end), peaks near a gene, TFs by species, peaks filtered by biotype (promoter, enhancer), and BED files for a TF-cell type pair. Use for TF co-occupancy,… - 95jaspar-database
Query the JASPAR database for Transcription Factor (TF) binding profiles. Use when retrieving Position Frequency Matrices (PFMs) or Position Weight Matrices (PWMs) for specific TFs, resolving gene symbols to JASPAR Matrix IDs, or getting TF metadata. Supports multiple output…