gi-annotation

Predicts gene and transcript structures from DNA sequences via the Genomic Intelligence annotation API.

1.1k|257|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ClawBio/ClawBio --skill gi-annotation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gi-annotation
Source: https://github.com/ClawBio/ClawBio/tree/main/skills/gi-annotation
Command: npx skills add https://github.com/ClawBio/ClawBio --skill gi-annotation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve?

Predicting gene boundaries, exons, and transcripts from raw DNA sequence normally requires installing tools like AUGUSTUS or Helixer with species-specific models. This skill submits a FASTA region to the hosted Genomic Intelligence annotation pipeline and returns predicted transcript structures in about 20 seconds for a 20 kbp region.

Core Features & Use Cases

  • De novo gene prediction: Predicts gene boundaries, intervals, and transcripts from sequence alone, with no external annotation database required.
  • Async job handling: Submits via the /v1/tasks/annotation/predict endpoint with respond-async, polls job progress, and renders a Markdown report plus full JSON result.
  • Reproducibility bundle: Every run writes command.sh and environment.json alongside the report for auditable reruns.
  • Use Case: Given a 19 kbp FASTA of the TP53 locus, run the demo to receive a table of predicted transcripts with start, end, and strand, matching TP53's multiple annotated isoforms.

Quick Start

Ask the agent to annotate the bundled TP53 demo sequence with gi-annotation, or provide your own single-record FASTA file between 1,000 and 500,000 bp along with a GI_API_KEY.

Frequently Asked Questions about gi-annotation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I predict genes and transcripts from a DNA sequence?▼

Provide a single-record FASTA file of 1,000 to 500,000 bp and run the gi-annotation CLI with --input and --output flags. The skill submits the sequence to the Genomic Intelligence API asynchronously and returns predicted transcripts with start, end, and strand in a Markdown report.

What API key do I need for Genomic Intelligence annotation?▼

The skill requires a Genomic Intelligence partner key set in the GI_API_KEY environment variable or passed via the --api-key flag. A shared hackathon key ships in .env.example, and individual keys can be requested at contact@genomicintelligence.ai.

What is the maximum sequence length for DNA annotation?▼

The API accepts sequences from 1,000 to 500,000 bp, counted after whitespace is stripped. Out-of-range inputs return a 422 validation_failed error, and the skill rejects them locally before sending a request.

Can I use gi-annotation for bacterial or plant genomes?▼

No, the underlying model is trained on human and a few other vertebrates, so bacterial, fungal, and plant predictions are out of distribution. For those organisms, use species-specific tools like AUGUSTUS with appropriate models.

Why does the first annotation request take longer?▼

The annotation pipeline is the heaviest Genomic Intelligence model, so the first request after a cold service takes over 30 seconds. Subsequent calls are warm and typically finish in about 20 seconds for a 20 kbp region.

Is gi-annotation suitable for clinical variant interpretation?▼

No, it is intended for research and development use only, not clinical or diagnostic decisions. Predicted gene structures are model outputs, so clinical interpretation should anchor to curated RefSeq or Ensembl annotations.