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 [email protected].

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.