matematicsolutions/awesome-matematic-skills-pl / dev-mcp/skills/matematic-marketplace-installer
matematic-marketplace-installer
VerifiedGeneruje skrypt instalacyjny MateMatic Marketplace dla prawników - Windows .bat (bez Git/npm). Użyj gdy - /marketplace install, "zainstaluj skille", "installer dla kancelarii", "jak zainstalować skille bez GitHub".
MateMatic Marketplace Installer
Generuje gotowe skrypty instalacyjne skilli MateMatic dla docelowych użytkowników (prawnicy, kancelarie) - bez wymagania Git, npm ani wiedzy technicznej.
Safety Tiers
| Tier | Operacje | Reguła |
|---|---|---|
| R | Podgląd listy skilli do instalacji | Bez potwierdzenia |
| M | Generowanie skryptu .bat / .ps1 | Pokaż zawartość przed zapisem |
| D | Nadpisanie istniejących skilli w ~/.claude/skills/ | Użytkownik wpisuje "potwierdzam" |
Tryby
/marketplace install [skill-slug]
Generuje install-matematic-skills.bat gotowy do uruchomienia przez prawnika.
/marketplace list
Wyświetla dostępne skille z awesome-matematic-skills-pl z opisem.
/marketplace check
Sprawdza co jest już zainstalowane w ~/.claude/skills/.
Workflow generowania instalatora
- Pobierz
marketplace.jsonzmatematicsolutions/awesome-matematic-skills-pl(ścieżka:.claude-plugin/marketplace.json) - Zapytaj które skille lub "wszystkie"
- Wygeneruj
install-matematic-skills.bat(patrz szablon poniżej) - Wygeneruj
README-instalacja.txtz instrukcją krok po kroku - Dostarcz oba pliki gotowe do wysłania klientowi
Szablon install-matematic-skills.bat
Szablon, nie gotowy plik. Tryb
/marketplace installpodstawia trzy placeholdery przed zapisem.batna dysk:
__GIT_REF__-> domyślnie tag najnowszej publikacji zmarketplace.json(np.refs/tags/v0.6.0); klient może wymusić inny przez--ref mainlub--ref vX.Y.Z. Pinowanie do taga = powtarzalna instalacja (audytowalna).__SKILL_SLUGS__-> lista slugów wybranych skilli, oddzielona spacjami (np.let-it-be redline-docx-pl saos-orzecznictwo).__EXTRACTED_DIR__-> nazwa katalogu po rozpakowaniu ZIP-a: dla tagavX.Y.Ztoawesome-matematic-skills-pl-X.Y.Z, dlamaintoawesome-matematic-skills-pl-main.Surowy szablon poniżej nie zadziała uruchomiony bez podstawienia.
@echo off
setlocal enabledelayedexpansion
chcp 65001 >nul
echo MateMatic Marketplace Installer
echo ================================
echo Instaluje skille AI dla Claude Code
echo.
:: Katalog docelowy
set "SKILLS_DIR=%USERPROFILE%\.claude\skills"
if not exist "%SKILLS_DIR%" mkdir "%SKILLS_DIR%"
:: Tymczasowy katalog pobrania
set "TMP_DIR=%TEMP%\matematic-install-%RANDOM%"
mkdir "%TMP_DIR%"
echo [1/4] Pobieranie skilli z MateMatic Marketplace...
:: __GIT_REF__ = refs/tags/vX.Y.Z (domyślnie najnowszy tag z marketplace.json) lub refs/heads/main (bleeding-edge).
powershell -Command "Invoke-WebRequest -Uri 'https://github.com/matematicsolutions/awesome-matematic-skills-pl/archive/__GIT_REF__.zip' -OutFile '%TMP_DIR%\skills.zip' -UseBasicParsing"
if not exist "%TMP_DIR%\skills.zip" (
echo BLAD: Nie udalo sie pobrac. Sprawdz polaczenie z Internetem.
pause
exit /b 1
)
echo [2/4] Rozpakowywanie...
powershell -Command "Expand-Archive -Path '%TMP_DIR%\skills.zip' -DestinationPath '%TMP_DIR%\extracted' -Force"
echo [3/4] Instalowanie skilli...
:: [LISTA SKILLI - generowana dynamicznie]
:: UWAGA: nazwa katalogu po Expand-Archive zalezy od ref ZIPa - dla taga vX.Y.Z bedzie "awesome-matematic-skills-pl-X.Y.Z", dla main "awesome-matematic-skills-pl-main". Tryb /marketplace install podstawia __EXTRACTED_DIR__.
:: Skille leza w pakietach: <plugin>\skills\<slug> (np. dokumenty\skills\redline-docx-pl) - szukamy sluga we wszystkich pakietach.
for %%S in (__SKILL_SLUGS__) do (
set "SRC="
for /d %%P in ("%TMP_DIR%\extracted\__EXTRACTED_DIR__\*") do if exist "%%P\skills\%%S\SKILL.md" set "SRC=%%P\skills\%%S"
set "DST=%SKILLS_DIR%\%%S"
if exist "!SRC!" (
:: UWAGA: rd /s /q usuwa lokalne modyfikacje w skillu. Klient ostrzezony w README-instalacja.txt.
if exist "!DST!" rd /s /q "!DST!"
xcopy /e /i /q "!SRC!" "!DST!" >nul
echo OK: %%S
) else (
echo POMINIETY: %%S ^(nie znaleziono^)
)
)
:: Zapis manifestu integralnosci skills-lock.json (SHA256 per zainstalowany skill) - patrz
:: sekcja "Integralnosc" ponizej. Self-contained (bez zewnetrznego pliku) - dziala tez u klienta
:: bez Git/npm. Hashuje TYLKO skille z tej instalacji (__SKILL_SLUGS__), nie cudze skille klienta.
echo [4/4] Zapis manifestu integralnosci...
powershell -Command ^
"$e=[ordered]@{}; foreach ($s in ('__SKILL_SLUGS__' -split '\s+' | Where-Object { $_ })) { $f = Join-Path '%SKILLS_DIR%' (Join-Path $s 'SKILL.md'); if (Test-Path $f) { $h = (Get-FileHash $f -Algorithm SHA256).Hash.ToLower(); $e[$s] = [ordered]@{ source='matematicsolutions/awesome-matematic-skills-pl'; sourceType='github'; ref='__GIT_REF__'; skillPath=((Get-ChildItem '%TMP_DIR%\extracted\__EXTRACTED_DIR__' -Directory | Where-Object { Test-Path (Join-Path $_.FullName \"skills\$s\SKILL.md\") } | Select-Object -First 1 | ForEach-Object { $_.Name + '/skills/' + $s + '/SKILL.md' })); computedHash=\"sha256:$h\" } } }; $json = ([ordered]@{version=1; skills=$e} | ConvertTo-Json -Depth 6); [System.IO.File]::WriteAllText('%SKILLS_DIR%\..\skills-lock.json', $json, (New-Object System.Text.UTF8Encoding($false)))"
:: Czyszczenie
rd /s /q "%TMP_DIR%"
echo.
echo ================================
echo Instalacja zakonczona.
echo Uruchom nowa sesje Claude Code.
echo Skille beda dostepne jako /nazwa-skilla
echo ================================
pause
Szablon README-instalacja.txt
INSTRUKCJA INSTALACJI - MateMatic Marketplace
=============================================
WYMAGANIA:
- Claude Code (pobierz z claude.ai/code)
- Polaczenie z Internetem
INSTALACJA:
1. Zweryfikuj zrodlo pliku - powinien pochodzic z oficjalnego release
github.com/matematicsolutions/awesome-matematic-skills-pl/releases.
Jezeli kancelaria ma polityke whitelistingu - zglos plik do IT przed otwarciem.
2. (ZALECANE dla kancelarii) Zweryfikuj sume SHA256:
- Pobierz z release page plik `checksums.txt`.
- W PowerShell w katalogu pobranego .bat uruchom:
Get-FileHash -Algorithm SHA256 install-matematic-skills.bat
- Porownaj z linia w checksums.txt. Jezeli niezgodne - NIE uruchamiaj, zglos
wsparcie@matematic.co.
3. Kliknij dwukrotnie install-matematic-skills.bat
(Windows SmartScreen moze pokazac ostrzezenie. Jezeli plik pochodzi z innego
zrodla niz oficjalny release - NIE uruchamiaj. Jezeli jest z release i polityka
kancelarii pozwala - kliknij "Wiecej informacji" -> "Uruchom i tak".
Prawa administratora NIE sa wymagane - skrypt pisze do %USERPROFILE%.)
4. Poczekaj az pojawi sie "Instalacja zakonczona!"
5. Uruchom Claude Code od nowa
6. Sprawdz: zapytaj "znajdz orzeczenia SN o dobru dziecka" - Claude siega po saos-orzecznictwo, wiec skille sa zaladowane
PROBLEMY:
- Jesli Windows blokuje skrypt: Wlasciwosci pliku -> Odblokuj
(Tylko gdy plik pochodzi z oficjalnego release. W innym wypadku - zglos IT.)
- Jesli brak Internetu: sprawdz firewall firmowy
Wsparcie: support@matematic.co
Uwagi techniczne
-
Nie wymaga Git (używa
Invoke-WebRequest+Expand-Archive) -
Nie wymaga npm/node
-
Działa na Windows 10/11 z PowerShell 5.1+
-
Skrypt nadpisuje istniejące skille o tych samych nazwach (lokalne modyfikacje skopiowanych skilli przepadają). Klient, który dostosował skill po instalacji, powinien zrobić kopię przed re-runem.
-
Ścieżka docelowa:
%USERPROFILE%\.claude\skills\(katalog skilli Claude Code w profilu użytkownika) -
Reproducible install: domyślny ref to najnowszy tag z
marketplace.json(audytowalna wersja). Tryb--ref mainpobieraHEAD(do testowania, nie do produkcji w kancelarii). -
Weryfikacja integralności SHA256 (v0.6.1+): wraz z każdym release MateMatic publikuje plik
checksums.txtjako asset release page zawierajacy SHA256 dla generowanegoinstall-matematic-skills.bat. Klient kancelarii powinien:- Pobrać
checksums.txtz tej samej strony co .bat. - Uruchomić
Get-FileHash -Algorithm SHA256 install-matematic-skills.batw PowerShell. - Porównać hex z linią w
checksums.txt(case-insensitive, lower-case standard).
Workflow generowania
checksums.txtjest częścią release pipeline MateMatic (gh release upload vX.Y.Z install-matematic-skills.bat checksums.txt). Klient dostaje hash spod tej samej autorytatywnej domenygithub.com/matematicsolutions/...co plik instalacyjny - nie potrzebuje osobnego kanału.Ograniczenie znane: GitHub nie publikuje stabilnej sumy dla automatycznie generowanych
archive/refs/tags/...zip(regeneruje przy każdym żądaniu).checksums.txtdotyczy konkretnie wygenerowanegoinstall-matematic-skills.bat(deterministyczny output skilla), nie archiwum całego repo. - Pobrać
Integralność (skills-lock.json)
Wzorzec zapożyczony z tutti-os/tutti (skills-lock.json: source + sourceType +
skillPath + computedHash SHA256 per skill). Uzupełnia checksums.txt: tamten chroni
plik .bat PRZED uruchomieniem, ten wykrywa, że zainstalowany skill cicho się zmienił
PO instalacji (wymiar „Supply chain" z audyt-kodu-25-wymiarow-pl).
Krok [4/4] w szablonie .bat liczy SHA256 SKILL.md każdego skilla z tej instalacji
i zapisuje skills-lock.json obok katalogu skilli (%USERPROFILE%\.claude\skills-lock.json),
razem z refem, z którego pobrano paczkę. Przy kolejnej instalacji lub audycie można
porównać hash i wykryć drift (ktoś ręcznie zmienił skill albo źródło podmieniło zawartość
pod tym samym slugiem), zamiast ufać, że „wygląda tak samo".
To narzędzie do wykrywania, NIE blokada - gdy hash się nie zgadza, poinformuj użytkownika, nie przerywaj automatycznie instalacji (kancelaria nie ma kontekstu, żeby ocenić, czy drift jest zamierzony).
Ręczne przeliczenie manifestu (np. audyt własnego katalogu skilli): scripts/write-skills-lock.ps1.
Wspólne reguły wtyczki dev-mcp (Dev-mcp)
Te reguły obowiązują w każdym skillu tej wtyczki, także gdy sam skill milczy. Są skopiowane do każdego skilla, więc działają zarówno po instalacji całej wtyczki, jak i pojedynczego skilla.
Plugin to narzędzia deweloperskie MateMatic: spec-driven development, kanon budowy MCP serverów, recenzent PR dla LegalTech, generator instalatora marketplace. Skierowany do osób budujących, nie do prawnika końcowego.
Reguły
- Wynik to projekt. Specyfikacje, recenzje i instalatory są punktem wyjścia, sprawdza je człowiek przed użyciem.
- Recenzja nie zastępuje testów. Recenzent PR wskazuje ryzyka (org scoping, audit_log, grounding, PII w logach); nie gwarantuje poprawności - kod nadal trzeba przetestować.
- Sekrety. Przy budowie MCP i recenzji kodu nie umieszczaj kluczy ani danych klienta w przykładach, logach ani promptach.
Zakres pluginu
Plugin daje warsztat deweloperski (advanced). Nie jest narzędziem do pracy prawnej - do tego są pozostałe pluginy huba.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |