Problem
The "Skill improvement" step in the collaboration skill instructs the agent to invoke capture-event with --type mistake. capture-event retired --type in favor of --tags, and its CLI now rejects --type as an unknown flag. An agent that follows the instruction literally gets an invalid-args error and records nothing. The step fires exactly when a skill has just caused a mistake, so the correction is lost at the worst possible moment for the guidance to fail.
Context
The instruction was rewritten in #714 — the commit that introduced capture-event and deleted the older record-skill-mistake skill it replaced. --type was valid then; it was later retired in favor of --tags (the capture-event CLI test now asserts --type is rejected as "the retired --type flag"), but the collaboration instruction was never updated to match.
The original report asked whether the step should instead point at record-skill-mistake. It should not: that skill was deliberately removed in #714 and no longer exists in the source — only a stale installed copy lingers on machines that haven't synced since. capture-event is the intended home for agent mistakes under the project's unified-substrate direction.
Beyond the broken flag, the instruction records an unattributed event: it names no offending skill and no detail, so a recalled mistake event isn't actionable. And mistake is not yet an established tag convention — only --tags fix is documented in capture-event.
Proposed solution
Correct the collaboration step to invoke capture-event with the current flags: tag the event mistake, attribute it to the skill at fault via --skill, and capture what went wrong and what the skill should have said. The --skill attribution is the substrate-native equivalent of what record-skill-mistake did by colocating a mistakes.md with the offending skill — it preserves the "which skill needs revising" linkage so a recalled event is actionable.
Document mistake as a tag convention in capture-event alongside the existing fix convention, so the group-recall rationale that justifies tagging holds for mistakes too.
No CLI change is needed: --tags already accepts arbitrary values and --skill already exists, so mistake is just data. The existing test that asserts --type is rejected stays as-is.
Acceptance criteria
Must have
Should have
Problem
The "Skill improvement" step in the
collaborationskill instructs the agent to invokecapture-eventwith--type mistake.capture-eventretired--typein favor of--tags, and its CLI now rejects--typeas an unknown flag. An agent that follows the instruction literally gets aninvalid-argserror and records nothing. The step fires exactly when a skill has just caused a mistake, so the correction is lost at the worst possible moment for the guidance to fail.Context
The instruction was rewritten in #714 — the commit that introduced
capture-eventand deleted the olderrecord-skill-mistakeskill it replaced.--typewas valid then; it was later retired in favor of--tags(thecapture-eventCLI test now asserts--typeis rejected as "the retired--typeflag"), but the collaboration instruction was never updated to match.The original report asked whether the step should instead point at
record-skill-mistake. It should not: that skill was deliberately removed in #714 and no longer exists in the source — only a stale installed copy lingers on machines that haven't synced since.capture-eventis the intended home for agent mistakes under the project's unified-substrate direction.Beyond the broken flag, the instruction records an unattributed event: it names no offending skill and no detail, so a recalled
mistakeevent isn't actionable. Andmistakeis not yet an established tag convention — only--tags fixis documented incapture-event.Proposed solution
Correct the
collaborationstep to invokecapture-eventwith the current flags: tag the eventmistake, attribute it to the skill at fault via--skill, and capture what went wrong and what the skill should have said. The--skillattribution is the substrate-native equivalent of whatrecord-skill-mistakedid by colocating amistakes.mdwith the offending skill — it preserves the "which skill needs revising" linkage so a recalled event is actionable.Document
mistakeas a tag convention incapture-eventalongside the existingfixconvention, so the group-recall rationale that justifies tagging holds for mistakes too.No CLI change is needed:
--tagsalready accepts arbitrary values and--skillalready exists, somistakeis just data. The existing test that asserts--typeis rejected stays as-is.Acceptance criteria
Must have
collaborationskill's mistake-recording step invokescapture-eventwith--tags mistake(not--type) and references no retired flag.--skilland directs the agent to capture what went wrong and what the skill should have said.capture-eventdocumentsmistakeas a tag convention alongsidefix.--type-rejection test and the content-path-conventions checks.Should have
mistakecapture — the collaboration instruction and thecapture-eventconvention agree on the flags and on what goes in the body.