Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

contextual-setup

/contextual-setup

Zapisuje kontekst projektu w katalogu context po raz pierwszy, z pliku planu, kilku pytań lub istniejącego kodu.

Repozytorium
contextual ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
9
Skrypty
0
Komentarze HTML
4
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.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 sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (4). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Zapisuje kontekst projektu w katalogu context po raz pierwszy, z pliku planu, kilku pytań lub istniejącego kodu.

Wyzwalacze z opisu

set up contextualset up the contextfill in the contextplan this project
Oryginalny opis (EN)

Use when the person says "set up contextual", "set up the context", "fill in the context" or "plan this project", or right after `usecontextual init`. Writes the project's context in context/ for the first time: from contextual-plan.md when there is one, from a few questions when the repo is empty, or from the existing code.

Jak działa

  1. 1. Find the path
  2. 2. Path 2: ask, then write the plan
  3. 3. Write the context from the plan
  4. 4. Finish
Sekcje z nagłówków SKILL.md, w oryginale · 38 linii, 564 słów
Podgląd SKILL.md
---
name: contextual-setup
description: Use when the person says "set up contextual", "set up the context", "fill in the context" or "plan this project", or right after `usecontextual init`. Writes the project's context in context/ for the first time: from contextual-plan.md when there is one, from a few questions when the repo is empty, or from the existing code.
license: MIT
---

# Set up the project context

`usecontextual init` laid down `AGENTS.md`, `CLAUDE.md` and the `context/` skeleton. Every place that needs content holds a `<!-- fill: … -->` comment. This skill replaces each comment with the project's real content and deletes the comment.

First read `context/.meta.json`. Its `cli` value is the command that runs the CLI in this repo, written `<cli>` below.

## 1. Find the path

Look at what's in the repo, ignoring `.git/`, `context/`, `AGENTS.md`, `CLAUDE.md`, the skill folders and what `init` added (a `package.json` whose only dependency is `usecontextual`, its lockfile, `node_modules/`, `.gitignore`).

- `context/idea.md` exists: setup already ran. Stop, and ask what the person wants changed.
- `contextual-plan.md` is at the repo root: **path 1**. Go to step 3.
- No plan file and nothing else in the repo: **path 2**. Go to step 2.
- No plan file, but there is code: **path 3**. Follow [references/existing-code.md](references/existing-code.md): scan, propose the features and their paths, wait for the person to confirm, then write. Change no code.

## 2. Path 2: ask, then write the plan

1. Ask the questions in [references/questions.md](references/questions.md), all in one message. Then wait for the answers.
2. Write `contextual-plan.md` at the repo root from the answers. Start from [assets/contextual-plan.md](assets/contextual-plan.md) and follow the format in [references/plan-file.md](references/plan-file.md). Keep the person's own words in Idea and Users.
3. Show the plan and ask the person to confirm it or say what to change. Don't write anything in `context/` until they confirm.

## 3. Write the context from the plan

Read `contextual-plan.md` in full. Then fill the files in the order given in [references/fill-from-plan.md](references/fill-from-plan.md), which says what goes where. Always add a first feature the plan doesn't list, `foundation`: it owns the app shell, layouts and config. Rules for every file:

- Keep every heading the template has, in order. Delete each `<!-- fill: … -->` comment once its content is written.
- Write only what the plan says or what follows directly from it. When something isn't decided, write "Not decided yet" and add the question to "Blocked / needs a human" in `context/status/main.md`.
- Never edit between `<!-- contextual:start -->` and `<!-- contextual:end -->` in `AGENTS.md`, and never edit `context/design/deslop.md` or `context/features/_index.md`.
- Paths 1 and 2 write no `log.md` or other feature files: setup isn't work on a feature, and a planned feature has only its `README.md`. (Path 3 gives each feature it finds all five files.) The definition of done in `AGENTS.md` starts with the first feature.

## 4. Finish

1. Move `contextual-plan.md` to `context/idea.md` without changing a character: plain `mv`, or `git mv` if `git ls-files contextual-plan.md` lists it. Then check that `context/idea.md` exists and the plan file is gone. From now on nobody edits `idea.md`.
2. Run `<cli> check --fix`. It rebuilds the feature index and stores the hash of `idea.md`. Then fix every error it reports and run it again, until there are 0 errors. Before any code exists, these warnings are expected: no code outside `context/`, and `shared:` paths that match no files yet.
3. If this is a git repo, commit everything setup wrote, plus what `init` added, as one commit on the default branch: `Set up Contextual`. Skip this if the person said not to commit.
4. Tell the person, in a few lines, what you wrote, the open questions waiting for them, and that "build the next feature" starts Phase 1.
Pliki w paczce (9)
  • SKILL.md 4 KB
  • assets/contextual-plan.md 1 KB
  • assets/decision.md 1 KB
  • assets/feature-README.md 1 KB
  • assets/stack-lib.md 1 KB
  • references/existing-code.md 4 KB
  • references/fill-from-plan.md 6 KB
  • references/plan-file.md 4 KB
  • references/questions.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie contextual-setup.

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

  • 90contextual-plan
    Planuje aplikację lub stronę przed budową: zadaje najwyżej pięć pytań, proponuje stos i kierunek designu i zapisuje plik planu.
  • 90contextual-next
    Wybiera kolejną funkcję z katalogu context, buduje ją na własnej gałęzi, weryfikuje, zapisuje w kontekście i zatrzymuje się do przeglądu.
  • 100contextual-review
    Przegląda zmiany w kodzie na tle transkryptów sesji i sprawdza, czy wykonanie zgadza się z zamiarem i projektem oraz czy nie ma błędów zależnych od kontekstu.
  • 100contextual-review
    Przegląda zmiany w kodzie na tle transkryptów sesji i sprawdza, czy wykonanie zgadza się z zamiarem i projektem oraz czy nie ma błędów zależnych od kontekstu.
  • 98contextual-retrieval
    Wdraża technikę Contextual Retrieval od Anthropic: kontekst generowany przez Claude Haiku dla każdego fragmentu, połączenie BM25, embeddingów i rerankingu oraz buforowanie promptów.
  • 86setup
    Konfiguruje pamięć projektu Aletheia w bieżącym projekcie, gdy użytkownik o to prosi lub brakuje katalogu .aletheia.

Uwagi i zgłoszenia

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