---
name: sequence
description: |
  Deterministic sequence utilities for translation, ORFs, restriction sites,
  Kozak context, primer checks, and local FASTA record matching.
tools:
  - sequence.analyze
  - sequence.match_reference
  - sequence.translate
  - sequence.find_orfs
  - sequence.find_restriction_sites
  - sequence.classify_kozak
  - sequence.check_primers
mutating: false
---

# Sequence

Use this skill when the user supplies a DNA sequence and asks for ORFs,
translation, restriction sites, Kozak context, primer checks, local FASTA
record matching, or simple bench-style sequence QA.

## Contract

- These tools operate only on supplied sequence strings and explicitly supplied
  local reference FASTA files.
- They do not use active genome context or external services.
- Report deterministic sequence facts directly. Add biological interpretation
  only when the user supplies enough context or separate source evidence.

## Tool Flow

- Use `sequence.analyze` when more than one deterministic sequence fact may be
  needed.
- Use `sequence.match_reference` when a local FASTA can identify the
  supplied sequence before downstream reasoning.
- Use `sequence.translate` for frame/strand translation.
- Use `sequence.find_orfs` for ATG-to-stop ORF discovery.
- Use `sequence.find_restriction_sites` for common enzymes or custom motifs.
- Use `sequence.classify_kozak` for ATG start-context checks.
- Use `sequence.check_primers` for basic GC, Wallace Tm, self-complementarity,
  and optional template amplicons.

Examples:

- `sequence.translate` with `{"sequence":"ATGGCCATTGTAATGGGCCGCTGA","frame":1}`
- `sequence.find_orfs` with `{"sequence":"AAATGAAATAG","min_aa":1}`
- `sequence.find_restriction_sites` with `{"sequence":"GAATTCGGATCC","enzymes":["EcoRI","BamHI"]}`
- `sequence.match_reference` with `{"sequence":"ATGAAATAA","reference_fasta":"refs.fa"}`

## Answering

Give the computed result and enough coordinates or frame details to make the
answer auditable. Do not turn sequence utility output into medical or
personal-genome interpretation.

## Cross-Capability Synthesis

A scope-limited result from this capability is not a final user-facing answer
when other Genomi capabilities can contribute orthogonal evidence to the same
question. Returning "cannot answer" while applicable capabilities remain
unexamined is a host-agent failure mode.

## Tools

### sequence.analyze

Run a compact deterministic sequence analysis bundle and point to focused sequence tools when needed.

**Use when**: The user supplies DNA/RNA sequence text and may need translation, ORF, motif, Kozak, or local FASTA identity facts.

**Why necessary**: Supplied DNA strings need deterministic sequence utilities before any biological interpretation.

**Example prompts**: Translate this DNA sequence and find ORFs.

**Result semantics**: Computes deterministic sequence facts from supplied text and optional local FASTA reference matches; no external annotation is performed.

### sequence.check_primers

Check basic primer properties and optional template amplicons.

**Use when**: Checks primer GC, melting temperature, self-complementarity, and optional amplicon context.

**Why necessary**: Primer checks combine basic thermodynamic and amplicon facts that are not variant evidence.

**Result semantics**: Performs lightweight deterministic primer checks; it does not replace full primer-design thermodynamics.

### sequence.classify_kozak

Classify Kozak sequence context around ATG start codons.

**Use when**: Checks Kozak/start-codon context around a supplied DNA sequence position.

**Why necessary**: Start-codon context is a specialized expression-design check and should stay separate from general translation.

**Result semantics**: Uses the simple -3 A/G and +4 G Kozak rule; experimental expression strength needs separate evidence.

### sequence.find_orfs

Find ATG-to-stop open reading frames in a supplied DNA sequence.

**Use when**: Finds open reading frames and coding-sequence candidates in a supplied DNA sequence.

**Why necessary**: ORF detection identifies candidate coding regions without relying on external annotation.

**Result semantics**: Finds simple ATG-to-stop ORFs from supplied sequence text; biological annotation requires separate source evidence.

### sequence.find_restriction_sites

Find common restriction enzyme or custom motif sites in a supplied DNA sequence.

**Use when**: Maps restriction enzyme sites and sequence motifs in a supplied DNA sequence.

**Why necessary**: Cloning and motif checks need exact site positions in the supplied sequence.

**Result semantics**: Reports motif positions in the supplied sequence; it does not model methylation or digestion conditions.

### sequence.match_reference

Match a supplied DNA sequence against local FASTA records and return record identifiers plus annotations.

**Use when**: The task supplies a DNA sequence and a local FASTA/reference set that can identify the sequence record before downstream reasoning.

**Why necessary**: Local FASTA matching identifies sequence records before downstream reasoning about that sequence.

**Result semantics**: Returns exact local FASTA record matches and header annotations; the host agent decides whether a matched record answers the question.

### sequence.translate

Translate a DNA sequence in a selected frame and strand using the standard genetic code.

**Use when**: Translates a supplied DNA sequence into codons or amino acids for the requested frame and strand.

**Why necessary**: Protein translation requires explicit frame and strand control rather than informal sequence reading.

**Result semantics**: Computes deterministic sequence facts from the supplied string only; no genome context or external IO is used.