Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

file-structure

/file-structure

Doradza układ plików projektu dla dokumentacji, eksperymentów i materiałów tymczasowych oraz przenosi pliki na życzenie.

Repozytorium
basePack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.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
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.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

Doradza układ plików projektu dla dokumentacji, eksperymentów i materiałów tymczasowych oraz przenosi pliki na życzenie.

Oryginalny opis (EN)

Recommend or reorganize project file layouts for development documentation, experiment routes, and temporary or retained material. Use for structure decisions and requested file moves; ordinary prose or algorithm edits alone are outside scope.

Jak działa

  1. Temporary and retained material
  2. Choose a pattern
  3. Propose or reorganize
  4. Extend the patterns
Sekcje z nagłówków SKILL.md, w oryginale · 39 linii, 536 słów
Podgląd SKILL.md
---
name: file-structure
description: "Recommend or reorganize project file layouts for development documentation, experiment routes, and temporary or retained material. Use for structure decisions and requested file moves; ordinary prose or algorithm edits alone are outside scope."
---

# File structure

Choose a layout by purpose, maintenance lifecycle, and execution or delivery boundaries. Preserve working project conventions. Treat directory names as navigation clues; verify knowledge and completion from the contents.

## Temporary and retained material

- Prefer project-root `tmp/<task>/` for one-off tests, trial runs, temporary scripts, disposable fixtures, caches and intermediate outputs. Keep disposable contents Git-ignored; retain a directory placeholder only when needed.
- Assume `tmp/` contents can disappear any time after the task ends, for example through daily cleanup. Before closure, record needed conclusions in documentation and move selected material worth retaining to its stable location.
- Use `artifacts/` for selected original evidence: logs, outputs and snapshots of executed scripts, effective configuration or inputs needed for later review. Select by retention need rather than saving all temporary work.
- Maintain source, reusable configuration, regression fixtures, stable input/version references and conclusions in their version-controlled owning locations. Retention and version control are separate decisions; classify by purpose and lifetime rather than size. Keep service state, shared dependencies and deliverables in stable locations independently usable after `tmp/` is cleared.

## Choose a pattern

| Current problem | Read |
| --- | --- |
| Long-term guidance, current implementation, active work, and history are mixed | [Development documentation](references/dev-docs.md) |
| Experiment routes have tangled code, dependencies, data, or results | [Experiment routes](references/experiment-packages.md) |
| Both problems occur | Read both references together and combine the layers |
| Another layout problem | Propose the smallest layout that fits its purpose, lifecycle, and execution or delivery boundaries |

Use the task and existing entry points to locate relevant directories, version-control boundaries, and materials. Batch known reads and reuse valid context. For a large repository, start with relevant indexes and retain locations for deeper reading; follow up when the findings require it.

## Propose or reorganize

For advice or review, return findings or a proposed tree and source-to-destination mapping as appropriate. Explain responsibilities, retained conventions and unresolved boundaries.

For authorized reorganization:

1. Before moving files, check source and destination paths, conflicts, nested repositories, uncommitted work, active processes, and external path dependencies.
2. Apply the path mapping within scope, preserving original evidence, version history and related attachments. Create useful files and folders plus structural directories required by the selected pattern. Treat deletion and archival according to their authorization; complete unaffected work and explain blocked moves.
3. Repair affected links, commands, configuration, imports, data locations and ignore rules. Run relevant path or lightweight execution checks, then report actual changes, checks and remaining work. Verify usability from evidence rather than directory appearance.

Keep one maintenance source for shared code and reuse it through declared dependencies or the project's module mechanism. Locate shared environments, models, and large artifacts through configuration. Keep shared assets and existing results in place unless their relocation, regeneration, or cleanup is part of the task.

## Extend the patterns

When skill maintenance is part of the task, add a useful new pattern as a reference covering its trigger, minimal tree, content and version boundaries, entry points, migration considerations and sources; add its selection condition to the table. Ordinary project advice uses the existing skill. Combine patterns as needed; project requirements and language conventions take precedence over example names.
Pliki w paczce (4)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/dev-docs.md 6 KB
  • references/experiment-packages.md 7 KB

Wersje

W bazie nie ma innych skilli o nazwie file-structure.

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

  • 90keep-why-repo-structure
    Ustala układ dokumentacji projektu i jedno miejsce dla każdego elementu wiedzy.
  • 100file-organization
    Projektuje lub przebudowuje strukturę projektu wokół funkcji, wspólnej warstwy, segmentu trasy lub pakietu, z konwencjami nazw.
  • 100file-operations
    Tworzy, czyta, edytuje, wyświetla i usuwa pliki oraz bada strukturę katalogów projektu.
  • 100readme-updater
    Aktualizuje README projektu na podstawie bieżącej struktury i kodu, gdy zmienia się układ katalogów lub pliki projektu.
  • 100organize-project
    Ocenia i poprawia strukturę projektu: układ folderów, rozmieszczenie plików, nazewnictwo i podział odpowiedzialności, z propozycją do akceptacji przed przenosinami.
  • 90file-upload
    Pomaga wdrożyć przesyłanie plików w Fusebase: od plików tymczasowych, przez zapisane, po adresy URL i deskryptory.

Uwagi i zgłoszenia

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