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

context-capsule

/context-capsule

Zapisuje kapsułę wznowienia bieżącej sesji: cel, na co czeka i następne działanie, by po wyczyszczeniu kontekstu wrócić dokładnie tam, gdzie stanęło.

Repozytorium
aigent-os ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.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 12.11.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 kapsułę wznowienia bieżącej sesji: cel, na co czeka i następne działanie, by po wyczyszczeniu kontekstu wrócić dokładnie tam, gdzie stanęło.

Oryginalny opis (EN)

Write a resume-ready capsule of the current session (objective, what it is waiting on, the next concrete action) so a /clear or an auto-compact can pick up exactly where this left off. Write it before compaction; nothing writes one for you at that point. Use for a checkpoint before risky work, before /clear, or when a thread ships.

Jak działa

  1. Steps
  2. Field rules
  3. Format
  4. Lifecycle
  5. When not to capsule
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 491 słów
Podgląd SKILL.md
---
name: context-capsule
description: Write a resume-ready capsule of the current session (objective, what it is waiting on, the next concrete action) so a /clear or an auto-compact can pick up exactly where this left off. Write it before compaction; nothing writes one for you at that point. Use for a checkpoint before risky work, before /clear, or when a thread ships.
---

# context-capsule

**The whole job: reconcile, write the capsule, confirm it, then stop.**

A capsule is a small markdown file with YAML frontmatter. A fresh session reads three fields from it and continues. It is state for the next session, not a transcript of this one.

## Steps

1. **Reconcile from live state.** Look at what is actually true now: `git status`, `git log -n 5`, the files you changed, any task list. Budget: 2 to 4 reads. Record what happened, not what was said. A capsule that restates the conversation instead of the repo state is the failure this skill exists to prevent.
2. **Write it with the helper**, which stamps the date, validates the fields and writes into the configured capsule directory:

   ```
   node "${CLAUDE_PLUGIN_ROOT}/scripts/capsule-lib.mjs" write \
     --objective "<what this work is for, one sentence>" \
     --waiting-on "<concrete items, owners, gates a fresh session must know>" \
     --next-action "<the one next step, specific enough to act on cold>" \
     --slug "<short-topic>" \
     --dir '${user_config.capsuleDir}'
   ```

   Run it from the project directory (do not `cd` elsewhere) and keep the `--dir` line exactly as written, single quotes included (they stop the shell expanding the placeholder when the option is unset). A configured path that itself contains a single quote is not supported. It carries the configured capsule directory. If the directory option is not set, that value is empty or still reads `${user_config.capsuleDir}` literally; then drop the `--dir` line and the helper uses the project default.

   Optional: `--body-file <path>` with your own body sections (see Format).
3. **Confirm.** The helper prints the path it wrote. Run `node "${CLAUDE_PLUGIN_ROOT}/scripts/capsule-lib.mjs" validate <that path>` and expect `VALID`. If it prints `INVALID`, fix the fields and write again.
4. **Stop.** Tell the user the capsule path in one line. If they asked for `/refresh`, tell them to run `/clear` next.

## Field rules

- `objective`, `waiting_on`, `next_valid_action` are required and must be non-empty. `waiting_on` is the resume contract: write it so a fresh session can act from it alone.
- `next_valid_action` must be a real action, not "resume the session" or "re-read the state". The helper refuses ceremony text.
- Do not paste secrets, tokens or credentials into a capsule. It is a plain file in the project.

## Format

Frontmatter fields: `id`, `parent_capsule_id`, `status: active`, `objective`, `waiting_on`, `resume_trigger`, `expires`, `trigger`, `next_valid_action`, `success_criteria`, `tags`, `created_at` (ISO-8601 with offset), `resolved_at`. Body sections: `Done (don't redo)`, `Historical-Errors -> Resolutions`, `Historical-Rejected-Approaches`, `Files-Read / Files-Modified`, `Operating-Facts`, `In-Flight Side Effects`, `Pending-Gates`, `Claimed-Rows`. The format is compatible with the full aigent-os install.

## Lifecycle

`active` then `resumed` (set automatically by the SessionStart hook when a `/clear` loads it) then done. Never edit `status` by hand. Capsules older than 14 days (plugin option `maxAgeDays`, or the `CONTEXT_CAPSULE_MAX_AGE_DAYS` env var, to change) are refused at resume with a message, not loaded.

## When not to capsule

Mid-thought (finish the thought first), or a trivial session a fresh start can rebuild from the repo.

Wersje

RepozytoriumWynikLicencja
Ta strona · wrg32786/aigent-os100MIT
wrg32786/aigent-os100MIT

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

  • 100contextsutra-context-capsule
    Tworzy, sprawdza i przycina przenośną kapsułę kontekstu projektu dla asystenta AI, na przykład przy eksporcie albo limicie długości.
  • 100clear-prep
    Przygotowuje projekt do czyszczenia kontekstu (/clear) lub kompaktowania bez utraty stanu: zapisuje pracę sesji w trwałych dokumentach i generuje jeden prompt wznowienia dla nowej sesji.
  • 90checkpoint
    Zapisuje punkt kontrolny pracy w sesji, by inny agent mógł ją podjąć po wyczyszczeniu kontekstu.
  • 100handoff
    Pisze ustrukturyzowany dokument przekazania i wznowienia, żeby kolejna sesja podjęła pracę dokładnie w tym samym miejscu, na przykład przed komendą /compact lub /clear.
  • 90capsule-compact
    Skraca łańcuch kapsuł kontekstu przez podsumowanie starszych kapsuł, gdy rośnie za długi albo trzeba go zwinąć ręcznie.
  • 90salesforce-case-capsule
    Definiuje wspólną kapsułę sprawy Salesforce do przekazania sprawy innemu agentowi z zachowaniem kontekstu, niepewności, jakości dowodów oraz statusu poufności i prywatności, z listą zakazów.

Uwagi i zgłoszenia

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