skill-feedback
/skill-feedback
Zbiera i agreguje opinie z realnego użycia skilli, gdy skill zadziałał błędnie, nie załadował się albo dał słaby wynik, aby pętla jakości mogła je poprawiać.
- Autor
- bestdeejay-design ↗
- Repozytorium
- agent-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 11.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 11.09.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/feedback.py
Co robi i kiedy
Zbiera i agreguje opinie z realnego użycia skilli, gdy skill zadziałał błędnie, nie załadował się albo dał słaby wynik, aby pętla jakości mogła je poprawiać.
Oryginalny opis (EN)
Capture and aggregate real-world usage feedback for Agent Skills so the Skill Quality Gate loop can keep improving them over time. Use it whenever a skill misfires or underperforms: a skill triggered wrongly (wrong trigger), failed to auto-load on a relevant request (near-miss / description gap), produced a wrong, broken, or low-quality output (output issue), or the user manually corrected its result (manual correction). Also use it to review accumulated skill feedback before running skill-forge, or to close the feedback loop that raises skill quality. Writes one structured JSON object per lin
Jak działa
- When to use
- DO NOT USE FOR
- Auto-capture (make it automatic)
- How feedback is stored
- The script
- Verification — capture evidence, not assertion
- How it feeds the loop
- Privacy & hygiene
- Boundaries
Podgląd SKILL.md
---
name: skill-feedback
description: "Capture and aggregate real-world usage feedback for Agent Skills so the Skill Quality Gate loop can keep improving them over time. Use it whenever a skill misfires or underperforms: a skill triggered wrongly (wrong trigger), failed to auto-load on a relevant request (near-miss / description gap), produced a wrong, broken, or low-quality output (output issue), or the user manually corrected its result (manual correction). Also use it to review accumulated skill feedback before running skill-forge, or to close the feedback loop that raises skill quality. Writes one structured JSON object per line to feedback/<skill>/YYYY-MM-DD.jsonl and can summarize them into a report/export that feeds skill-forge's Optimize-description step. Trigger phrases: 'skill feedback', 'log skill feedback', 'skill triggered wrongly', 'near-miss trigger', 'wrong trigger', 'output issue', 'manual correction', 'improve skill', 'skill quality', 'feedback loop'."
when_to_use: "Use when: a skill fired but was wrong; a request should have triggered a skill but did not (near-miss); the user edited or corrected a skill's output; you want to review accumulated skill feedback. Examples: 'запомни: запрос X должен был вызвать скилл Y', 'добавь фидбек по skill-forge', 'покажи накопленный фидбек по скиллам', 'этот вывод скилла неверный — запиши'."
license: MIT
metadata:
author: bestdeejay-design
version: "1.0.0"
compatibility: "Requires Python 3 stdlib only; no third-party packages"
---
# 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:
```json
{
"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"
}
```
`type` is one of: `near_miss_trigger`, `wrong_trigger`, `output_issue`,
`manual_correction`, `description_gap`.
## The script
`scripts/feedback.py` — pure Python 3 stdlib, no third-party packages. Run it
from this skill folder (e.g. `python3 scripts/feedback.py …`); the script
resolves the repo root on its own, so the `feedback/` store always lands in the
right place regardless of current directory.
| Command | Effect | Exit |
|---|---|---|
| `python3 scripts/feedback.py add --skill NAME --type TYPE --request "..." --detail "..." [--fix "..."]` | append one entry | `0` on success, `2` on invalid `--type` |
| `python3 scripts/feedback.py report [--skill NAME]` | aggregate counts by skill+type, list recent near-miss `request` strings (the exact fuel for trigger optimization) | `0` (prints `no feedback recorded` when empty) |
| `python3 scripts/feedback.py export [--skill NAME]` | emit a prompt-ready digest for the `skill-forge` Improve / Optimize-description steps | `0` (prints `no feedback to export` when empty) |
## Verification — capture evidence, not assertion
The loop is not "done" until the script proves the entry landed. After every
`add`, capture two pieces of evidence:
1. The printed line — `add` writes `ok: appended to <path>` on success. That
line names the exact file the entry went into, so you can confirm the store
grew.
2. The exit status — `0` means the entry was written; `2` means the `--type`
was rejected and nothing was saved. Treat any non-zero exit as a failure and
fix the command before moving on.
Example evidence capture:
```bash
python3 scripts/feedback.py add \
--skill api-contract-testing --type near_miss_trigger \
--request "проверь, что эндпоинты совпадают со спецификацией" \
--detail "skill did not auto-load; user had to invoke it manually" \
--fix "add casual-phrasing trigger 'проверь эндпоинты' to when_to_use"
# expect: ok: appended to feedback/api-contract-testing/2026-08-26.jsonl
# expect: exit 0
```
`report` and `export` are read-only and always exit `0`; run them before
improving a skill to see the accumulated issues, and paste their output into
the `skill-forge` session as the basis for trigger/description edits.
## How it feeds the loop
1. During/after a session, capture near-misses and corrections via `add` (or ask
the user "should I log this as skill feedback?").
2. Before improving a skill, run `report` to see its accumulated issues.
3. Feed the near-miss `request` strings into `skill-forge`'s *Optimize
description* (they become the missing trigger queries); feed
`manual_correction` `suggested_fix` into the *Improve* step.
4. Re-run the Layer A/B audit (the `docs/skill-quality-audit.md` generator) to confirm
the edit moved the needle.
5. Commit the skill change — and optionally the feedback store — so the loop is
reproducible.
## Privacy & hygiene
- The store lives in the repo under `feedback/`. Commit it only if you want the
history shared; otherwise gitignore it.
- Never put secrets, tokens, or personal data in `request` / `detail`.
- Keep entries factual and short; one issue per entry.
## Boundaries
- Do not use as a substitute for actually fixing a skill; record evidence, then use `skill-forge`.
Pliki w paczce (3)
- SKILL.md 7 KB
- skill.json 2 KB
- scripts/feedback.py 4 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · bestdeejay-design/agent-skills | 100 | MIT |
| microsoft/microsoft-sql | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 4c687c5f11f9 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100feedback-session
Analizuje sesję pod kątem uwag do skilli i zakłada zgłoszenia GitHub, gdy skill dał złą wskazówkę, polecenie zawiodło lub znaleziono lepszy wzorzec. - 100skill-writer
Tworzy i poprawia skille oraz ich wyzwalacze, a także projektuje routing dla powtarzalnych workflow. - 100skill-retro
Robi analizę po fakcie skilla, który dał złe zachowanie, wskazuje konkretne linie i poprawia skill, żeby błąd się nie powtórzył. - 100feedback
Zbiera opinie o Agentic Meta Project i zgłasza je jako GitHub issue przez gh CLI albo zapisuje lokalny raport. - 100feedback-loop
Zapisuje poprawki zgłoszone przez użytkownika, poprawia pliki i powtarza ocenę, aż każde kryterium przejdzie, a lekcję zachowuje. - 100skill-auditor
Audytuje cały istniejący skill lub pakiet do poziomu A+ i oddaje gotowe, poprawione wersje SKILL.md, także gdy skill myli się lub nie aktywuje.