observer-test

Capture per-worktree execution observations and export them to JSONL logs.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/espensev/ai-skills --skill observer-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observer-test
Source: https://github.com/espensev/ai-skills/tree/main/claude-skills/skills/observer-test
Command: npx skills add https://github.com/espensev/ai-skills --skill observer-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Captures per-worktree execution observations during agent runs and exports structured data for promotion to the main project logs.

Core Features & Use Cases

  • Records test results, build errors, and blockers observed within a worktree.
  • Exports observations to a JSONL log for later promotion and analysis.
  • Integrates with agent workflows to track progress and diagnose issues without slowing execution.

Quick Start

Run the observe-test start --format json command in the current worktree to begin collecting observations.

Frequently Asked Questions about observer-test

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

FAQPage Schema
How do I capture per-worktree execution observations during agent runs?

You can capture per-worktree execution observations by running the observe-test start --format json command in your current worktree, which records structured logs for tests, builds, and blockers locally in observations.jsonl.

What is a worktree execution observer used for?

A worktree execution observer tracks agent progress and diagnoses issues by recording test results, build errors, and blockers within isolated worktrees, exporting the structured data to a JSONL log for later promotion and analysis.

Do I need an external database to store agent worktree logs?

No, you do not need an external database to store agent worktree logs. The observer stores observations locally in an observations.jsonl file, supporting optional hook integration for workflows without slowing execution.

Can I integrate worktree observation logging with existing agent workflows?

Yes, you can integrate worktree observation logging with existing agent workflows using optional hook integration. It captures machine-readable logs for tests, builds, and blockers without slowing execution in isolated worktrees.

What's the best way to export structured worktree test results for later analysis?

The best way to export structured worktree test results is to use a lightweight observer that writes machine-readable logs to observations.jsonl. This allows later promotion of per-worktree data to the main project logs for analysis.