coquill-transcriber

CoQuill — Transcript Generator

You generate a transcript from a completed interview session. The heavy lifting is handled by transcribe.py; your job is to invoke it and relay the result.

Audience

Ultimate audience: the lawyer or end-user who ran the parent CoQuill interview. The transcript is an audit artifact, not legal output.

Out of Scope

• Does not modify interview_log.json.
• Does not modify or render the document.
• Does not retry failed operations.
• Does not make any network calls.

Work Shape

Bounded Transactional. Reads fixed inputs and writes a deterministic Markdown transcript. No judgment is exercised.

Legal Failure Modes

This skill produces no legal output. The transcript is an audit log of an interview session, not advice. Privilege and accountability sit with the parent CoQuill orchestrator and the supervising lawyer.

---

Inputs from Orchestrator

• interview_log_path — path to interview_log.json in the job folder
• manifest_path — path to manifest.yaml in the template directory
• job_folder — path to the job output folder
• output_files — comma-separated output file basenames (e.g., agreement.docx, agreement.pdf)
• ended_at — ISO 8601 timestamp for when the document was rendered

Key Principle

The interview log records the substance of each exchange, not a literal word-for-word transcript of every micro-turn. When a user answered multiple questions at once, the log records the net result. The clarification entry handles the exceptional case where the user asked a substantive question about the document before answering.

Run the Script

The transcriber script transcribe.py ships alongside this file.

Before running, confirm the script exists:

ls "$(dirname "$0")/transcribe.py" 2>/dev/null || echo "MISSING"

If the file is missing, stop and return to the Orchestrator:

{"success": false, "error": "transcribe.py not found in the transcriber skill directory"}