Przejdź do treści
Biblioteka skilli
Edukacja · Planowanie

map-corpus

/map-corpus

Przygotowuje folder z materiałami do nauki tak, aby dało się z niego uczyć się systematycznie, mapując tematy i zależności między nimi.

Repozytorium
dalcom-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

85/ 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ść20 / 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
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Przygotowuje folder z materiałami do nauki tak, aby dało się z niego uczyć się systematycznie, mapując tematy i zależności między nimi.

Oryginalny opis (EN)

Use when the user points to a study-material folder and asks to make it teachable. Not for remote, credential, publish, deploy, or irreversible changes.

Jak działa

  1. Fixing the two paths
  2. Reading everything without changing anything
  3. Recording sources and concepts
  4. Ordering ideas for learning
  5. Writing the map
Sekcje z nagłówków SKILL.md, w oryginale · 31 linii, 604 słów
Podgląd SKILL.md
---
name: map-corpus
description: 'Use when the user points to a study-material folder and asks to make it teachable. Not for remote, credential, publish, deploy, or irreversible changes.'
---

# Map corpus

You turn a folder of study material into a teachable map: a single `CORPUS.md` at the workspace root that inventories every file, names what the material teaches, and orders ideas so prerequisites come first. You never change anything inside the corpus folder itself, and the only file you write is workspace-root `CORPUS.md` (restoring the prior file, or deleting a newly created one, rolls the run back).

You need the corpus folder path and the workspace root where `CORPUS.md` will live. If the corpus path is missing, ask once; if it stays unavailable, stop blocked. An existing `CORPUS.md` may be replaced, but only once the new map is complete and verified.

## Fixing the two paths

Expand `~`, resolve the corpus folder to an absolute path, and confirm it exists and is a directory. Resolve the output path too, and confirm it is exactly workspace-root `CORPUS.md` without touching the corpus root. If the corpus is missing, not a directory, or the output path resolves anywhere else (or writing it would modify the corpus root), write nothing and return `blocked` with both resolved paths and the failed validation.

## Reading everything without changing anything

Recursively list every file under the corpus root and attempt to read each one as-is: no conversion, no modification. Mark each file readable or unreadable and keep the observed reason for every unreadable one. Unreadable files get no conversion attempt and no converter recommendation; a map built from the readable remainder is still valid, but only if every unreadable file is disclosed with its reason.

## Recording sources and concepts

For every readable file, write one source row with its path relative to the corpus root, its material kind, and either the headings worth citing or `reference only`. The row count must equal the readable file count, and no absolute path may appear in a row or a citation.

Then name what the readable material teaches. For each concept, keep the source's own term where one exists, add a one-sentence definition, list its prerequisites, and give at least one citation anchor. Every readable file must be accounted for: either it contributes a concept or its source row says `reference only`. Form citations as `<path-relative-to-corpus-root>#<heading-slug>`, falling back to `<path-relative-to-corpus-root>:<start>-<end>` only when the source has no headings.

## Ordering ideas for learning

Lay the concepts out as one flat numbered list with every prerequisite placed before its dependents. When two concepts depend on each other, put first whichever the corpus introduces first and disclose the cycle on the other concept's line. If the list would grow past roughly forty entries, merge concepts the corpus always teaches together.

## Writing the map

Assemble `CORPUS.md` with these parts in this order: `# Corpus: <name>`; `corpus_root: <absolute path>`; `mapped: <YYYY-MM-DD>`; a `## Sources` table with `File`, `Kind`, and `Cite from` columns; a `## Concepts` numbered list whose entries carry the term, definition, `Needs:`, and `Source:` (using `Needs: none` where there are no prerequisites); and a `## Unreadable` list of each unreadable relative path with its reason, or `None` when everything read cleanly.

Before writing, verify source accounting, concept coverage, citation form, and prerequisite order against the enumerated corpus. If any of those cannot be established from the material, keep any existing `CORPUS.md` untouched, write no partial replacement, and return `blocked` naming the unmet condition. Only when verification passes, wholly replace workspace-root `CORPUS.md`. On success, report the file path with counts of readable sources, unreadable sources, and concepts. If the write itself fails, say so with the error, claim nothing, and restore the prior file when one exists or remove the incomplete new file otherwise.
Pliki w paczce (3)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/CORPUS-FORMAT.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · gosuda/dalcom-skills85Apache-2.0
OutlineDriven/outline-driven-development90Apache-2.0
melodic-software/claude-code-plugins84MIT

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

  • 100eztudy
    Zamienia folder z materiałami w lokalny notatnik do nauki, który odpowiada z cytatami i generuje quizy, fiszki oraz mapy myśli.
  • 90repo-understand
    Mapuje strukturę programu nauczania i wymagania wstępne zawarte w repozytorium, zanim zacznie uczyć z niego osobę uczącą się.
  • 100study-material
    Wyciąga pełną treść z PDF, dokumentów i obrazów, a potem porządkuje ją w strukturalne materiały HTML do nauki.
  • 90pr-walkthrough
    Tworzy interaktywną mapę PR w formie grafu, by zorientować się w zmianie, bez działań zdalnych, publikacji ani wdrożeń.

Uwagi i zgłoszenia

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