Skill Documents

Expert Agents That Learn From Experience

Skill Documents are procedural guides stored in PostgreSQL that teach agents how to do their jobs. After every execution, a post-job assessor proposes improvements — agents get smarter over time.

Request Access
FIX

In-place repair of an underperforming skill based on failure patterns.

DERIVED

New skill variant created from a successful execution pattern.

CAPTURED

Brand-new skill discovered from expert output — institutional knowledge captured.

Built for Continuous Improvement

DB-Backed & Versioned

Skills live in PostgreSQL with full version lineage. Every accepted improvement is a new generation with diff history.

BM25 Retrieval

The right skills are selected per job using BM25 lexical ranking against the job description — not static lists. Top 5 skills injected into the expert's context.

Three Evolution Modes

FIX repairs underperforming skills. DERIVED creates new variants from successful patterns. CAPTURED discovers brand-new skills from execution output.

Post-Execution Assessor

After every mini-job, a Haiku model analyzes the output and proposes improvements. Non-blocking — suggestions queue for human review.

Quality Gate

Suggestions are deduplicated and capped at 6 per job, 2 per skill. Previously dismissed patterns are filtered out automatically.

Health Metrics

Every skill tracks selection count, success rate, and failure rate. Skills with high failure rates auto-generate FIX proposals via the metric monitor.

How Skills Evolve

01

Expert Executes

The agent runs a job. BM25 selects the most relevant skill documents and injects them into the system prompt.

02

Assessor Observes

After the mini-job, a Haiku model reviews the output and proposes up to 3 skill improvements per execution.

03

Quality Gate Filters

Suggestions are deduplicated, capped, and compared against previously dismissed patterns to prevent noise.

04

Human Reviews

Queued suggestions appear in the Skills dashboard with a diff view. You accept or reject each one.

05

Skill Updates

Accepted suggestions become a new generation in the version lineage. The next job benefits immediately.

NEW

Auto-Generate Skills from Integrations

Connect an MCP or OpenAPI integration and generate a skill document in one click. Orqista reads the tool list, sends it to Haiku, and produces a ready-to-use skill document in the correct format — no manual writing needed.

POST /integrations/:id/generate-skill

Skill Health at a Glance

Metric What it tracks Triggers
timesSelected How often BM25 chose this skill
successCount Jobs completed with this skill
failureCount Jobs errored/timed-out with this skill Auto FIX proposal at ≥ 40% failure rate (min 5 uses)

Skills That Get Better With Every Job

Start with 5 built-in skills and watch your expert agents accumulate institutional knowledge over time.

Request Early Access