capture-feedback

Records user feedback on agent behavior as tagged guidance-refinement candidates in a knowledge base.

1|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/williamthorsen/codeassembly --skill capture-feedback-williamthorsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: capture-feedback
Source: https://github.com/williamthorsen/codeassembly/tree/main/packages/agents/content/skills/capture-feedback
Command: npx skills add https://github.com/williamthorsen/codeassembly --skill capture-feedback-williamthorsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a user corrects an AI agent's behavior, the lesson is often lost or applied as an over-fitted one-off rule. This Skill applies the immediate fix and captures the generalized lesson as a structured record, so guidance refinement happens later in bulk rather than reactively. ## Core Features & Use Cases - Immediate fix application: Applies concrete corrections to artifacts (code, docs, PR bodies) directly, asking for confirmation only when the change is ambiguous or risky. - Feedback classification: Distinguishes misapplied existing guidance (tagged mistake) from net-new desired behaviors, recording uncertainty when classification is unclear. - Structured record capture: Delegates to the capture-event skill to append a feedback-tagged record with summary, impact rating, and candidate refinement target to a project or default knowledge base. - Use Case: A user says "stop title-casing headings; the rule is sentence case." The agent fixes the heading, then records the error-correction pair tagged feedback,mistake for a later bulk guidance-refinement pass. ## Quick Start Tell the agent to use capture-feedback to apply your correction and record the lesson for future guidance refinement.

Frequently Asked Questions about capture-feedback

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

FAQPage Schema
How do I record feedback on AI agent behavior for later refinement?

Invoke the capture-feedback skill with your correction or desired behavior. It applies any concrete fix immediately, then appends a generalized feedback-tagged record to a knowledge base via the capture-event skill for a later bulk refinement pass.

How does capture-feedback decide between a mistake and a new behavior?

It checks whether relevant guidance already existed. If a rule was in force and the agent missed it, the record is tagged mistake; if no guidance covered the behavior, it is recorded as a new refinement proposal. Uncertainty is noted in the record body.

What runtime requirements does capture-feedback need?

It requires Node.js version 24 or later and a kb.yaml registry (in .agents/kb.yaml or ~/.agents/kb.yaml) declaring a destination store. Without a usable registry, the fix is still applied but the record goes uncaptured.

Does capture-feedback edit guidance files directly?

No. It only captures the feedback as a candidate record; actual refinement of skills, subagents, rulebooks, or general guidance is deferred to a later pass that recalls accumulated feedback records in bulk to avoid over-fitting single data points.

How do I correct an inaccurate feedback record?

Use capture-event with the --amend flag and the record id to rewrite the record in place. Capture a fresh record only when the correction represents a genuinely distinct lesson.