Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

knowledge-capture

/knowledge-capture

Zapisuje trwałą wiedzę po większym zadaniu, korekcie użytkownika, odkryciu nieoczywistej przyczyny lub konwencji projektu oraz na prośbę o zapamiętanie albo zapomnienie.

Repozytorium
godmode ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zapisuje trwałą wiedzę po większym zadaniu, korekcie użytkownika, odkryciu nieoczywistej przyczyny lub konwencji projektu oraz na prośbę o zapamiętanie albo zapomnienie.

Oryginalny opis (EN)

Use when a substantial task finishes, when the user corrects the agent or states a preference, when a non-obvious cause or project convention is discovered the hard way, or when the user asks the agent to remember or forget something

Jak działa

  1. The Prime Directive
  2. When to Use
  3. Where Memory Lives
  4. The Protocol
  5. Entry Format
  6. What Good Lessons Look Like
  7. Cognitive Traps
  8. Guardrails
  9. Connections
Sekcje z nagłówków SKILL.md, w oryginale · 121 linii, 1 184 słów
Podgląd SKILL.md
---
name: knowledge-capture
description: "Use when a substantial task finishes, when the user corrects the agent or states a preference, when a non-obvious cause or project convention is discovered the hard way, or when the user asks the agent to remember or forget something"
---

# Knowledge Capture

Each session starts cold. What you learned the hard way in this one (a hidden convention, a root-cause signature, a preference the user stated) is lost unless it is written where the next session will read it. **Save durable, non-obvious lessons into the harness's own memory or the project's docs, never into a store of your own invention, and keep that memory short, current and free of duplicates.**

## The Prime Directive

```
SAVE WHAT THE NEXT SESSION CANNOT REDISCOVER CHEAPLY, WHERE IT WILL BE READ
```

No exceptions. No workarounds. No shortcuts.

## When to Use

**Required:**
- The user corrects your approach or states a preference ("always use pnpm", "no emoji in commits").
- A bug's root cause was non-obvious and could recur.
- You found a project convention or gotcha by trial and error.
- A plan was badly misjudged and you now know why.
- The user says "remember", "note that", "from now on", or "forget".
- A substantial task finishes and something above happened during it.

**Skip:**
- Anything the repository already records: code structure, git history, the README, existing instruction files.
- Facts that only matter to this conversation (the current task's progress, a temporary path).
- Generic knowledge any capable engineer has.
- Secrets, tokens, personal data. Never store these.
- The user declines.

## Where Memory Lives

Use the harness's native mechanism. The exact paths and commands for each harness are in its reference file under `godmode:using-godmode` (for example [the Claude Code reference](../using-godmode/references/claude-code-tools.md)).

| Kind of lesson | Destination | Who may write |
|---|---|---|
| Agent's own learnings about this user or project (preferences, gotchas, past decisions) | the harness's auto memory, if it has one | you, freely |
| Standing instructions for every agent on the project | the project instruction file (CLAUDE.md, AGENTS.md, GEMINI.md) or a rules file | propose; the user approves |
| Knowledge a human contributor also needs | the project's docs (README, `docs/`, ADRs, comments at the code) | you, as part of the change |
| Personal preferences across projects | the user-level instruction file | propose; the user approves |

When the harness has no auto memory, the instruction file or the project docs are the only destinations, so every save is a proposal to the user. Never create a parallel store (a private JSON file, a custom database, a memory folder the harness does not load). Memory nobody loads is not memory.

## The Protocol

1. **Reflect.** At the end of a substantial task, or right after a correction, ask: what did I learn that I would want at the start of the next session? What surprised me? What did the user have to tell me?
2. **Filter.** Keep a lesson only if it is durable (still true next month), non-obvious (not derivable from the code in a minute) and actionable (it changes what an agent does). Drop the rest.
3. **Distil.** Write it as one fact in plain words, generalised from the specific case. Add why it holds and how to apply it. Convert relative dates ("yesterday", "next sprint") to absolute dates.
4. **Deduplicate.** Read the destination first. If the fact is already there, update that entry rather than adding another. If a stored entry contradicts the new evidence, replace it and keep the newer fact.
5. **Write** to the right destination from the table. One fact per entry; keep any index file to one line per entry.
6. **Promote with consent.** When the same lesson has held three or more times, or the user stated it as a rule, propose moving it into the project instruction file. Quote the line you would add. Add it only on a yes.
7. **Prune.** When you read memory at the start of work, remove or fix entries that are wrong, stale, or duplicated. Verify any file, function or flag a memory names before acting on it; memory reflects what was true when written.

## Entry Format

For auto memory or a notes file:

```markdown
---
name: prefers-pnpm
description: User wants pnpm, never npm or yarn, in this repository
---

Use pnpm for every install and script in this repository.
**Why:** the lockfile is pnpm-lock.yaml and CI fails on npm installs (corrected 2026-10-25).
**How to apply:** run `pnpm install`, `pnpm test`; never add package-lock.json.
```

For a proposed instruction-file line, one imperative sentence the user can accept or edit:

```text
- Use pnpm for all installs and scripts; CI rejects npm lockfiles.
```

## What Good Lessons Look Like

| Weak | Strong |
|---|---|
| "Fixed the login bug" | "Session cookies here need `SameSite=None; Secure`; the app is embedded in an iframe on the partner site." |
| "User likes clean code" | "User rejects string-typed errors; use the `AppError` subclasses in `src/errors.ts`." |
| "Tests were flaky" | "Tests that pass locally and fail in CI here are timezone bugs; CI runs in UTC, dev machines do not." |
| "Remember the config" | "Runtime config is read from `src/config/runtime.ts`, not from `.env`; `.env` only feeds the build." |

## Cognitive Traps

| Rationalisation | Truth |
|---|---|
| "I'll remember this" | The next session starts with nothing. Write it or lose it. |
| "It's obvious" | It is obvious now, with full context. Cold, it is invisible. |
| "More memory is better" | Memory loads into every session and costs context. Short and current beats complete. |
| "I'll keep my own notes file" | A store the harness does not load is never read. Use the native one. |
| "The user said it once; I'll add a rule" | Rules in instruction files are the user's. Propose; do not write unasked. |
| "This old entry is probably still right" | Memory reflects the past. Verify before acting; fix or delete if wrong. |
| "Save the whole debugging story" | Save the lesson. The story is in the git log. |

## Guardrails

**Never:**
- Store secrets, credentials, tokens or personal data.
- Write to the user's instruction files without approval.
- Invent a memory store the harness does not load.
- Save what the repository already records.
- Add a duplicate entry instead of updating the existing one.
- Act on a remembered file, flag or function without checking it still exists.

**Always:**
- Read the destination before writing to it.
- Write one fact per entry, with why and how to apply it.
- Use absolute dates.
- Remove entries newer evidence contradicts.
- Tell the user in one line what you saved and where.

## Connections

- `godmode:using-godmode`: the harness reference files name each harness's memory paths and commands.
- `godmode:fault-diagnosis`: a non-obvious root cause is a prime lesson to capture.
- `godmode:review-response`: repeated review feedback becomes a lesson or a proposed rule.
- `godmode:codebase-conventions`: conventions found here feed later conformity checks.
- `godmode:completion-gate`: the end of a verified task is the natural moment to reflect.
- `godmode:writing-skills`: a lesson that applies to every project may belong in a skill instead.

Wersje

RepozytoriumWynikLicencja
Ta strona · NoobyGains/godmode100MIT
ARCASSystems/FounderOS100MIT
bordenet/superpowers-plus100MIT
steipete/clawdis90MIT
openclaw/openclaw86MIT

Migawka bazy z 13.11.2026 · wersja paczki ed1e1c2499c9 (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

  • 82memory
    Zapisuje, zmienia lub usuwa trwałą informację, gdy użytkownik prosi o zapamiętanie albo zapomnienie.
  • 100remember
    Zapisuje trwałą lekcję w agent-memory, gdy użytkownik poprawia Claude, podaje preferencję lub regułę albo prosi o zapamiętanie.
  • 100persistent-memory
    Zapisuje do ograniczonych plików pamięci fakty trwałe po naprawie błędu, poprawce od użytkownika lub odkryciu niejawnej konwencji projektu, żeby przetrwały między sesjami.
  • 100remember
    Zapisuje trwałą lekcję w agent-memory, gdy użytkownik poprawia Codex, podaje preferencję lub regułę albo dzieli się wnioskiem z debugowania.
  • 100learning-capture
    Zapisuje trwałe wnioski przez bezpośrednią edycję kontekstu, gdy użytkownik poprawia Claude w sposób uogólnialny, podaje stałą preferencję albo prosi o zapamiętanie.
  • 100remember
    Zapisuje trwały fakt, decyzję lub preferencję w memini, w tym po poprawce użytkownika, odkryciu przyczyny błędu albo decyzji architektonicznej, przez narzędzie memory_remember.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.