skill-feedback

Skill Feedback — capture the fuel for skill improvement

This skill closes the loop opened by docs/SKILL_QUALITY_GATE.md. The Quality Gate tells you whether a skill is good; this skill tells you how to make it better next time by recording what happened in real usage and turning it into a feed for skill-forge.

Without a feedback capture, improvement is guesswork. With it, every near-miss trigger and every manual correction becomes a concrete edit to a skill's description / when_to_use / body.

When to use

• A skill should have triggered but did not (near-miss): the user's request was in-scope but the auto-load missed it.
• A skill triggered wrongly: the wrong skill loaded for the request.
• A skill produced a wrong / broken / low-quality output (output issue).
• The user manually corrected the skill's output (edited the result, or told you "no, do it differently").
• You want to review what has piled up before running skill-forge.

DO NOT USE FOR

• General chat feedback, venting, or notes unrelated to a specific skill — those belong in memory or the session log, not the skill feedback store.
• Capturing secrets or personal data — never log credentials or PII in entries.

Auto-capture (make it automatic)

For the loop to run without manual nudging, capture feedback proactively. Append the rule from AGENTS_FRAGMENT.md (repo root) to your opencode AGENTS.md. Then any near-miss / manual correction is logged automatically — no explicit "remember this" needed. Each consumer grows their own skills locally; see docs/SKILL_QUALITY_GATE.md Layer C.

How feedback is stored

Each entry is one JSON object on its own line in:

feedback/<skill-name>/YYYY-MM-DD.jsonl

Entry schema:

{
  "ts": "2026-08-26T14:03:00",
  "skill": "api-contract-testing",
  "type": "near_miss_trigger",
  "request": "проверь, что эндпоинты совпадают со спецификацией",
  "detail": "skill did not auto-load; user had to invoke it manually",
  "suggested_fix": "add casual-phrasing trigger 'проверь эндпоинты' to when_to_use",
  "source": "user"
}