cat:collect-results

Extract commits, file changes, token metrics, and status from a subagent worktree.

101|2|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/cowwoc/cat --skill cat-collect-results
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cat:collect-results
Source: https://github.com/cowwoc/cat/tree/main/plugin/skills/collect-results
Command: npx skills add https://github.com/cowwoc/cat --skill cat-collect-results

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill consolidates subagent outputs by extracting commits, file changes, token metrics, and status from a completed worktree to prepare for reintegration into the parent task.

Core Features & Use Cases

  • Collects commits, files changed, token metrics, and status updates from a finished subagent.
  • Validates token metrics and presents a user-visible report prior to merging into the parent task branch.
  • Updates the parent STATE.md with collection results and readiness for merge.

Quick Start

Run: collect-results <SUBAGENT> to begin collecting results from a subagent after its task completes.

Frequently Asked Questions about cat:collect-results

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

FAQPage Schema
How do I collect subagent results from a completed worktree?

To collect subagent results, run collect-results on the subagent to extract commits, file changes, token metrics, and status updates from the worktree for reintegration into the parent task.

What is the best way to merge subagent outputs into a parent task branch?

The best way to merge subagent outputs is to validate token metrics and generate a user-visible collection report before updating the parent STATE.md with the readiness status for the merge.

How does token metric validation work during subagent collection?

Token metric validation works by reading .completion.json or token data from the subagent worktree to verify resource usage before presenting a collection report for the parent task merge.

Can I collect partial results if a subagent stalls before finishing?

Yes, you can collect partial results if a subagent stalls. The collection process applies when a subagent finishes, stalls, or requires a partial collection from its current worktree state.

What file formats do I need to prepare a parent-state update after subagent completion?

To prepare a parent-state update, you need access to the subagent worktree to read .completion.json, token data, and optional STATE.md or completion reports to verify the collection.