claire

Orchestrates transcript ingestion, tagging, and persona generation into BigQuery and Drive via subagents.

1|Updated May 29, 2026
One-click install
npx skills add https://github.com/borderux/recursica-knowledge --skill claire-borderux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claire
Source: https://github.com/borderux/recursica-knowledge/tree/main/agents/claire
Command: npx skills add https://github.com/borderux/recursica-knowledge --skill claire-borderux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning raw interview transcripts into structured, searchable research data requires parsing, dictionary correction, tagging, analysis, and persona synthesis — work that fails quietly when one agent tries to do it all. Claire orchestrates this pipeline for one client at a time, delegating each stage to a subagent with a deliberately restricted tool set so no single agent can both make a correction and manufacture the evidence justifying it. ## Core Features & Use Cases - Transcript ingest pipeline: Dispatches Scribe, Lexicon, Tagger, and Analyst in order, one transcript per run, writing transcript_lines, conversations, participants, tags, and findings to a per-client BigQuery dataset. - Per-interview write-ups and personas: Analyst renders evidence-cited field notes as Google Docs in the client's Drive folder; Percy builds versioned, per-population persona sets from tagged lines. - Fenced multi-client isolation: Enforces one Drive folder and one BigQuery dataset per client through per-client MCP servers, a pre-flight configuration check, and a hard rule against pre-filling config values. - Use Case: Point Claire at a client's Drive folder of 40 interview transcripts; she plans the work list, ingests and tags each transcript exactly once, writes a field-notes doc per interview, and reports live row counts with skips and failures itemized. ## Quick Start Ask Claire to process the folder of interview transcripts for this client and report what was ingested, skipped, and tagged.

Frequently Asked Questions about claire

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

FAQPage Schema
How do I ingest interview transcripts into BigQuery with an AI agent?▼

Dispatch Claire with the client's Drive folder; she asks Scribe to run the ingest tool in plan mode, then processes one transcript per dispatch. The tool parses, deduplicates, and writes transcript_lines, conversations, and participants via MERGE on deterministic keys.

How does Claire prevent one client's data from leaking into another's?▼

Isolation is enforced by per-client fenced MCP servers (bq-<slug> and drive-<slug>) with allowedDatasets, not by the prompt. Claire runs a pre-flight check and refuses to work if the fenced tools or a non-empty config block are missing.

Can Claire run on opencode or other agent runtimes?▼

No. The build targets only Buzz and Claude Code because opencode lacks per-tool MCP allowlists, so it cannot express rules like Lexicon holding no Drive tools. That tool separation is what keeps the pipeline trustworthy.

Why must transcripts never be processed twice, and how is it prevented?▼

A transcript's identity is its Drive file id, and conversation_id is derived from it, never generated. The plan mode lists each interview once, resolves duplicate formats, and re-ingestion is idempotent via MERGE writes with explicit skip reporting.

What happens when a transcript ingest stops partway through?▼

A partial outcome is treated as a failure, never reported as ingested with a smaller count. The conversation stays at status ingesting with an ingest cursor, so re-dispatching Scribe resumes from where the chunk loop stopped.

How are personas generated from tagged interview data?▼

Percy extracts cited observations per participant, clusters on behavior within one population, and writes a versioned persona set through write_persona_set. Every attribute cites a transcript line, and only a human can promote a draft version to current.