[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77KHPQ6H2P7B2EWFAA5XKBF":3,"skill-same:01M77KHPQ6H2P7B2EWFAA5XKBF":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":39,"repositoryHtmlUrl":40,"repositoryHomepageUrl":41,"ownerHtmlUrl":42,"ownerBlogUrl":6,"ownerDescription":43,"updatedAt":44,"install":45,"resources":57},"01M77KHPQ6H2P7B2EWFAA5XKBF","ksef-accountant-pl",null,"Asystent ksiegowy Krajowego Systemu e-Faktur (KSeF) w jezyku polskim. Uzyj przy pracy z KSeF 2.0 API, fakturami FA(3), zgodnoscia z polskim VAT, przetwarzaniem e-faktur, dopasowywaniem platnosci, rejestrami VAT (JPK_V7), fakturami korygujacymi, mechanizmem podzielonej platnosci (MPP) lub polskimi przeplywami ksiegowymi. Dostarcza wiedze domenowa do wystawiania faktur, przetwarzania zakupow, klasyfikacji kosztow, wykrywania fraudu i prognozowania cash flow w ekosystemie KSeF.","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fk\u002Fksef-accountant-pl\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ksef-accountant-pl\ndescription: \"Asystent ksiegowy Krajowego Systemu e-Faktur (KSeF) w jezyku polskim. Uzyj przy pracy z KSeF 2.0 API, fakturami FA(3), zgodnoscia z polskim VAT, przetwarzaniem e-faktur, dopasowywaniem platnosci, rejestrami VAT (JPK_V7), fakturami korygujacymi, mechanizmem podzielonej platnosci (MPP) lub polskimi przeplywami ksiegowymi. Dostarcza wiedze domenowa do wystawiania faktur, przetwarzania zakupow, klasyfikacji kosztow, wykrywania fraudu i prognozowania cash flow w ekosystemie KSeF.\"\nlicense: MIT\nhomepage: https:\u002F\u002Fgithub.com\u002Falexwoo-awso\u002Fskills\nsource: https:\u002F\u002Fgithub.com\u002Falexwoo-awso\u002Fskills\u002Ftree\u002Fmain\u002Fksef-accountant-pl\ndisableModelInvocation: true\ndisable-model-invocation: true\nallowModelInvocation: false\ninstruction_only: true\nhas_executable_code: false\ncredential_scope: \"optional-user-provided\"\nenv:\n  KSEF_TOKEN:\n    description: \"Token API KSeF do uwierzytelniania sesji. Dostarczany przez uzytkownika — skill nie generuje, nie przechowuje ani nie przesyla tokenow. Konfiguruj TYLKO po zweryfikowaniu, ze platforma wymusza flage disableModelInvocation (patrz sekcja Model bezpieczenstwa i skill.json).\"\n    required: false\n    secret: true\n  KSEF_ENCRYPTION_KEY:\n    description: \"Klucz szyfrowania Fernet do bezpiecznego przechowywania tokenow. Uzycie opcjonalne — przyklad wzorca bezpieczenstwa opisanego w dokumentacji referencyjnej. Konfiguruj TYLKO po zweryfikowaniu, ze platforma wymusza flage disableModelInvocation.\"\n    required: false\n    secret: true\n  KSEF_BASE_URL:\n    description: \"Bazowy URL API KSeF. Domyslnie https:\u002F\u002Fksef-demo.mf.gov.pl (DEMO). Produkcja: https:\u002F\u002Fksef.mf.gov.pl — wymaga jawnej zgody uzytkownika. Uzywaj produkcji TYLKO po pelnej weryfikacji bezpieczenstwa platformy.\"\n    required: false\n    default: \"https:\u002F\u002Fksef-demo.mf.gov.pl\"\n---\n\n# Agent Ksiegowy KSeF\n\nSpecjalistyczna wiedza do obslugi Krajowego Systemu e-Faktur (KSeF) w srodowisku KSeF 2.0 ze struktura FA(3). Wspiera zadania ksiegowe zwiazane z fakturowaniem elektronicznym w Polsce.\n\n## Model bezpieczenstwa\n\nTen skill jest **wylacznie instrukcyjny** — sklada sie z plikow Markdown zawierajacych wiedze domenowa, wzorce architektoniczne i przyklady kodu. Nie zawiera zadnego kodu wykonywalnego, binarek, skryptow instalacyjnych ani zaleznosci runtime.\n\n**Gwarancje po stronie skilla:**\n- `disableModelInvocation: true` \u002F `disable-model-invocation: true` — zadeklarowane zarowno w metadanych frontmatter (oba formaty: camelCase i kebab-case) jak i w dedykowanym manifescie [`skill.json`](skill.json). Skill nie powinien byc wywolywany autonomicznie przez model.\n- `secret: true` — zmienne srodowiskowe `KSEF_TOKEN` i `KSEF_ENCRYPTION_KEY` sa oznaczone jako sekrety w frontmatter i `skill.json`, sygnalizujac platformie, ze musza byc izolowane i nie moga byc logowane ani wyswietlane.\n- Brak kodu wykonywalnego — wszystkie przyklady (Python, XML, JSON) to ilustracje pogladowe, NIE kod uruchamiany przez skill.\n- Brak instalacji — skill nie zapisuje plikow na dysk, nie pobiera zaleznosci, nie modyfikuje konfiguracji systemu.\n- Dedykowany manifest [`skill.json`](skill.json) — maszynowo czytelny plik z metadanymi bezpieczenstwa, deklaracjami zmiennych srodowiskowych i ograniczeniami. Jesli platforma nie parsuje frontmatter SKILL.md poprawnie, powinna odczytac metadane z `skill.json`.\n\n**UWAGA — weryfikacja metadanych rejestru przed instalacja:**\n\nFlagi bezpieczenstwa sa zadeklarowane w dwoch zrodlach: frontmatter SKILL.md i [`skill.json`](skill.json). Mimo to, platforma hostingowa moze nie odczytac lub nie wymusic tych flag. **Przed instalacja MUSISZ wykonac ponizsze kroki:**\n\n1. **Sprawdz metadane rejestru** — po dodaniu skilla do platformy, otworz widok metadanych rejestru (registry metadata) wyswietlany przez platforme. Zweryfikuj, ze pole `disable-model-invocation` jest ustawione na `true` oraz ze zmienne srodowiskowe (`KSEF_TOKEN`, `KSEF_ENCRYPTION_KEY`, `KSEF_BASE_URL`) sa widoczne z oznaczeniem `secret`. Jesli platforma pokazuje `not set`, `false` lub nie wyswietla tych pol — flagi NIE sa wymuszane.\n2. **Jesli metadane rejestru nie pasuja do frontmatter\u002Fskill.json** — traktuj skill jako wyzszego ryzyka: NIE udostepniaj danych uwierzytelniajacych (tokenow, certyfikatow, kluczy), NIE konfiguruj zmiennych srodowiskowych (`KSEF_TOKEN`, `KSEF_ENCRYPTION_KEY`), NIE zezwalaj na autonomiczne uzycie.\n3. **Zweryfikuj izolacje zmiennych srodowiskowych** — potwierdz, ze platforma izoluje env vars i nie loguje\u002Fwyswietla ich wartosci w konwersacji.\n4. **Jesli platforma nie wymusza flag** — skontaktuj sie z dostawca platformy w celu wlaczenia obslugi `disableModelInvocation` (lub parsowania `skill.json`) lub nie instaluj skilla z dostepem do jakichkolwiek danych uwierzytelniajacych.\n\n**Gwarancje zalezne od platformy:**\n- Wymuszanie flagi `disableModelInvocation` zalezy od platformy hostingowej. Sam frontmatter nie zapewnia ochrony — wymaga wsparcia po stronie platformy.\n- Izolacja zmiennych srodowiskowych (env vars) zalezy od platformy. Skill deklaruje je jako opcjonalne, ale nie kontroluje jak platforma je przechowuje i udostepnia.\n- Jesli platforma nie wymusza tych ustawien, traktuj skill jako wyzszego ryzyka i nie udostepniaj mu danych uwierzytelniajacych ani dostepu produkcyjnego.\n\n## Ograniczenia\n\n- **Tylko wiedza — brak wykonywania kodu** - Dostarcza wiedze domenowa, wzorce architektoniczne i wskazowki. Wszystkie przyklady kodu (w tym ML\u002FAI) sa edukacyjne i pogladowe. Skill NIE uruchamia modeli ML, NIE wykonuje inferencji, NIE wymaga runtime'ow Python\u002Fsklearn ani zadnych binarek. Agent wyjasnia algorytmy i sugeruje kod do implementacji przez uzytkownika.\n- **Nie jest porada prawna ani podatkowa** - Informacje odzwierciedlaja stan wiedzy na dzien sporadzenia i moga byc nieaktualne. Zawsze zalecaj konsultacje z doradca podatkowym przed wdrozeniem.\n- **AI wspiera, nie decyduje** - Opisy funkcji AI (klasyfikacja kosztow, wykrywanie fraudu, predykcja cash flow) to architektura referencyjna i wzorce implementacyjne. Agent dostarcza wiedze o algorytmach i pomaga pisac kod — nie podejmuje wiazacych decyzji podatkowych ani finansowych.\n- **Wymagane potwierdzenie uzytkownika** - Zawsze wymagaj jawnej zgody uzytkownika przed: blokowaniem platnosci, wysylaniem faktur na produkcyjny KSeF, modyfikacja zapisow ksiegowych lub jakimkolwiek dzialaniem z konsekwencjami finansowymi.\n- **Dane uwierzytelniajace zarzadzane przez uzytkownika** - Tokeny KSeF API, certyfikaty i klucze szyfrowania musza byc dostarczone przez uzytkownika przez zmienne srodowiskowe (zadeklarowane w metadanych: `KSEF_TOKEN`, `KSEF_ENCRYPTION_KEY`, `KSEF_BASE_URL`) lub menedzer sekretow. Skill nigdy nie przechowuje, nie generuje, nie przesyla ani nie prosi o dane uwierzytelniajace niejawnie. **NIGDY nie wklejaj danych uwierzytelniajacych (tokenow, kluczy, certyfikatow) bezposrednio w rozmowie z agentem** — uzyj zmiennych srodowiskowych lub menedzera sekretow platformy. Przyklady uzycia Vault\u002FFernet w dokumentacji referencyjnej to wzorce architektoniczne do implementacji przez uzytkownika.\n- **Uzyj DEMO do testow** - Produkcja (`https:\u002F\u002Fksef.mf.gov.pl`) wystawia prawnie wiazace faktury. Uzyj DEMO (`https:\u002F\u002Fksef-demo.mf.gov.pl`) do developmentu i testow.\n- **Wylaczone autonomiczne wywolanie** - Skill ustawia `disableModelInvocation: true` i `disable-model-invocation: true` w metadanych frontmatter (oba formaty nazewnictwa) oraz w dedykowanym manifescie [`skill.json`](skill.json). Oznacza to, ze model nie powinien wywolywac tego skilla autonomicznie — wymaga jawnej akcji uzytkownika. **UWAGA:** Frontmatter i `skill.json` to deklaracje — nie gwarancje. Wymuszanie zalezy od platformy. Przed uzyciem zweryfikuj, ze metadane rejestru (registry metadata) wyswietlane przez platforme rowniez pokazuja `disable-model-invocation: true`. Jesli platforma pokazuje `not set` lub `false`, flaga nie jest wymuszana i skill moze byc wywolywany autonomicznie (patrz sekcja \"Model bezpieczenstwa\" powyzej).\n\n## Checklist przed instalacja\n\nPrzed instalacja skilla i konfiguracja zmiennych srodowiskowych wykonaj ponizsze kroki:\n\n- [ ] Zweryfikuj metadane rejestru platformy — pole `disable-model-invocation` musi pokazywac `true`\n- [ ] Zweryfikuj, ze platforma odczytala deklaracje env vars z frontmatter lub [`skill.json`](skill.json) — zmienne `KSEF_TOKEN` i `KSEF_ENCRYPTION_KEY` musza byc widoczne jako sekrety (`secret: true`)\n- [ ] Potwierdz, ze platforma izoluje zmienne srodowiskowe (nie loguje, nie wyswietla w konwersacji)\n- [ ] Przetestuj skill wylacznie ze srodowiskiem DEMO (`https:\u002F\u002Fksef-demo.mf.gov.pl`) przed jakimkolwiek uzyciem produkcyjnym\n- [ ] NIE wklejaj tokenow, kluczy ani certyfikatow bezposrednio w rozmowie — uzyj env vars lub menedzera sekretow\n- [ ] Jesli metadane rejestru nie pasuja do frontmatter\u002Fskill.json — NIE konfiguruj danych uwierzytelniajacych i zglos problem dostawcy platformy\n\n## Glowne kompetencje\n\n### 1. Obsluga KSeF 2.0 API\n\nWystawianie faktur FA(3), pobieranie faktur zakupowych, zarzadzanie sesjami\u002Ftokenami, obsluga trybu Offline24 (awaryjny), pobieranie UPO (Urzedowe Poswiadczenie Odbioru).\n\nKluczowe endpointy:\n```http\nPOST \u002Fapi\u002Fonline\u002FSession\u002FInitToken     # Inicjalizacja sesji\nPOST \u002Fapi\u002Fonline\u002FInvoice\u002FSend          # Wyslanie faktury\nGET  \u002Fapi\u002Fonline\u002FInvoice\u002FStatus\u002F{ref}  # Sprawdzenie statusu\nPOST \u002Fapi\u002Fonline\u002FQuery\u002FInvoice\u002FSync    # Zapytanie o faktury zakupowe\n```\n\nZobacz [references\u002Fksef-api-reference.md](references\u002Fksef-api-reference.md) - pelna dokumentacja API z uwierzytelnianiem, kodami bledow i rate limiting.\n\n### 2. Struktura FA(3)\n\nRoznice FA(3) vs FA(2): zalaczniki do faktur, typ kontrahenta PRACOWNIK, rozszerzone formaty konta bankowego, limit 50 000 pozycji w korekcie, identyfikatory JST i grup VAT.\n\nZobacz [references\u002Fksef-fa3-examples.md](references\u002Fksef-fa3-examples.md) - przyklady XML (faktura podstawowa, wiele stawek VAT, korekty, MPP, Offline24, zalaczniki).\n\n### 3. Przeplywy ksiegowe\n\n**Sprzedaz:** Dane -> Generuj FA(3) -> Wyslij KSeF -> Pobierz nr KSeF -> Ksieguj\n`Wn 300 (Rozrachunki) | Ma 700 (Sprzedaz) + Ma 220 (VAT nalezny)`\n\n**Zakupy:** Odpytuj KSeF -> Pobierz XML -> Klasyfikuj AI -> Ksieguj\n`Wn 400-500 (Koszty) + Wn 221 (VAT) | Ma 201 (Rozrachunki)`\n\nZobacz [references\u002Fksef-accounting-workflows.md](references\u002Fksef-accounting-workflows.md) - szczegolowe przeplywy z dopasowywaniem platnosci, MPP, korektami, rejestrami VAT i zamknieciem miesiaca.\n\n### 4. Funkcje wspomagane AI (architektura referencyjna)\n\nPonizsze opisy to wzorce implementacyjne i architektura referencyjna. Skill NIE uruchamia modeli ML — dostarcza wiedze o algorytmach, pomaga projektowac pipeline'y i pisac kod do implementacji w systemie uzytkownika. Przyklady kodu w plikach referencyjnych (Python, sklearn, pandas) to pseudokod pogladowy — skill nie zawiera wytrenowanych modeli, artefaktow ML ani plikow wykonywalnych.\n\n- **Klasyfikacja kosztow** - Wzorzec: historia kontrahenta -> dopasowanie slow kluczowych -> model ML (Random Forest). Flaguj do przegladu jesli confidence \u003C 0.8.\n- **Wykrywanie fraudu** - Wzorzec: Isolation Forest dla anomalii kwotowych, scoring dla phishing invoices, analiza grafow dla VAT carousel.\n- **Predykcja cash flow** - Wzorzec: Random Forest Regressor na podstawie historii kontrahenta, kwot i wzorcow sezonowych.\n\nZobacz [references\u002Fksef-ai-features.md](references\u002Fksef-ai-features.md) - koncepcyjne algorytmy i wzorce implementacji (wymagaja sklearn, pandas — nie sa zaleznoscia tego skilla).\n\n### 5. Compliance i bezpieczenstwo (wzorce implementacyjne)\n\nPonizsze to rekomendowane wzorce bezpieczenstwa do implementacji w systemie uzytkownika. Skill dostarcza wiedze i przyklady kodu — nie implementuje tych mechanizmow sam.\n\n- Weryfikacja Bialej Listy VAT przed platnosciami\n- Szyfrowane przechowywanie tokenow (wzorce Fernet\u002FVault — do implementacji przez uzytkownika)\n- Audit trail wszystkich operacji\n- Strategia backup 3-2-1\n- Zgodnosc z RODO (anonimizacja po okresie retencji)\n- RBAC (kontrola dostepu oparta na rolach)\n\nZobacz [references\u002Fksef-security-compliance.md](references\u002Fksef-security-compliance.md) - wzorce implementacji i checklista bezpieczenstwa.\n\n### 6. Faktury korygujace\n\nPobierz oryginal z KSeF -> Utworz korekte FA(3) -> Powiaz z nr KSeF oryginalu -> Wyslij do KSeF -> Ksieguj storno lub roznicowo.\n\n### 7. Rejestry VAT i JPK_V7\n\nGenerowanie rejestrow sprzedazy\u002Fzakupow (Excel\u002FPDF), JPK_V7M (miesieczny), JPK_V7K (kwartalny).\n\n## Troubleshooting - szybka pomoc\n\n| Problem | Przyczyna | Rozwiazanie |\n|---------|-----------|-------------|\n| Faktura odrzucona (400\u002F422) | Nieprawidlowy XML, NIP, data, brak pol | Sprawdz UTF-8, waliduj schemat FA(3), weryfikuj NIP |\n| Timeout API | Awaria KSeF, siec, godziny szczytu | Sprawdz status KSeF, retry z exponential backoff |\n| Nie mozna dopasowac platnosci | Niezgodna kwota, brak danych, split payment | Rozszerzone wyszukiwanie (+\u002F-2%, +\u002F-14 dni), sprawdz MPP |\n\nZobacz [references\u002Fksef-troubleshooting.md](references\u002Fksef-troubleshooting.md) - pelny przewodnik troubleshooting.\n\n## Pliki referencyjne\n\nLaduj w zaleznosci od zadania:\n\n| Plik | Kiedy czytac |\n|------|-------------|\n| [skill.json](skill.json) | Manifest metadanych — flagi bezpieczenstwa, deklaracje env vars, ograniczenia. Zrodlo prawdy dla rejestrow i skanerow. |\n| [ksef-api-reference.md](references\u002Fksef-api-reference.md) | Endpointy KSeF API, uwierzytelnianie, wysylanie\u002Fpobieranie faktur |\n| [ksef-legal-status.md](references\u002Fksef-legal-status.md) | Daty wdrozenia KSeF, wymagania prawne, kary |\n| [ksef-fa3-examples.md](references\u002Fksef-fa3-examples.md) | Tworzenie lub walidacja struktur XML faktur FA(3) |\n| [ksef-accounting-workflows.md](references\u002Fksef-accounting-workflows.md) | Zapisy ksiegowe, dopasowanie platnosci, MPP, korekty, rejestry VAT |\n| [ksef-ai-features.md](references\u002Fksef-ai-features.md) | Klasyfikacja kosztow, wykrywanie fraudu, algorytmy predykcji cash flow |\n| [ksef-security-compliance.md](references\u002Fksef-security-compliance.md) | Biala Lista VAT, bezpieczenstwo tokenow, audit trail, RODO, backup |\n| [ksef-troubleshooting.md](references\u002Fksef-troubleshooting.md) | Bledy API, problemy walidacji, wydajnosc |\n\n## Zasoby oficjalne\n\n- Portal KSeF: https:\u002F\u002Fksef.podatki.gov.pl\n- KSeF DEMO: https:\u002F\u002Fksef-demo.mf.gov.pl\n- KSeF Produkcja: https:\u002F\u002Fksef.mf.gov.pl\n- API Bialej Listy VAT: https:\u002F\u002Fwl-api.mf.gov.pl\n- KSeF Latarnia (status): https:\u002F\u002Fgithub.com\u002FCIRFMF\u002Fksef-latarnia\n","# Agent Ksiegowy KSeF\n\nSpecjalistyczna wiedza do obslugi Krajowego Systemu e-Faktur (KSeF) w srodowisku KSeF 2.0 ze struktura FA(3). Wspiera zadania ksiegowe zwiazane z fakturowaniem elektronicznym w Polsce.\n\n## Model bezpieczenstwa\n\nTen skill jest **wylacznie instrukcyjny** — sklada sie z plikow Markdown zawierajacych wiedze domenowa, wzorce architektoniczne i przyklady kodu. Nie zawiera zadnego kodu wykonywalnego, binarek, skryptow instalacyjnych ani zaleznosci runtime.\n\n**Gwarancje po stronie skilla:**\n- `disableModelInvocation: true` \u002F `disable-model-invocation: true` — zadeklarowane zarowno w metadanych frontmatter (oba formaty: camelCase i kebab-case) jak i w dedykowanym manifescie [`skill.json`](skill.json). Skill nie powinien byc wywolywany autonomicznie przez model.\n- `secret: true` — zmienne srodowiskowe `KSEF_TOKEN` i `KSEF_ENCRYPTION_KEY` sa oznaczone jako sekrety w frontmatter i `skill.json`, sygnalizujac platformie, ze musza byc izolowane i nie moga byc logowane ani wyswietlane.\n- Brak kodu wykonywalnego — wszystkie przyklady (Python, XML, JSON) to ilustracje pogladowe, NIE kod uruchamiany przez skill.\n- Brak instalacji — skill nie zapisuje plikow na dysk, nie pobiera zaleznosci, nie modyfikuje konfiguracji systemu.\n- Dedykowany manifest [`skill.json`](skill.json) — maszynowo czytelny plik z metadanymi bezpieczenstwa, deklaracjami zmiennych srodowiskowych i ograniczeniami. Jesli platforma nie parsuje frontmatter SKILL.md poprawnie, powinna odczytac metadane z `skill.json`.\n\n**UWAGA — weryfikacja metadanych rejestru przed instalacja:**\n\nFlagi bezpieczenstwa sa zadeklarowane w dwoch zrodlach: frontmatter SKILL.md i [`skill.json`](skill.json). Mimo to, platforma hostingowa moze nie odczytac lub nie wymusic tych flag. **Przed instalacja MUSISZ wykonac ponizsze kroki:**\n\n1. **Sprawdz metadane rejestru** — po dodaniu skilla do platformy, otworz widok metadanych rejestru (registry metadata) wyswietlany przez platforme. Zweryfikuj, ze pole `disable-model-invocation` jest ustawione na `true` oraz ze zmienne srodowiskowe (`KSEF_TOKEN`, `KSEF_ENCRYPTION_KEY`, `KSEF_BASE_URL`) sa widoczne z oznaczeniem `secret`. Jesli platforma pokazuje `not set`, `false` lub nie wyswietla tych pol — flagi NIE sa wymuszane.\n2. **Jesli metadane rejestru nie pasuja do frontmatter\u002Fskill.json** — traktuj skill jako wyzszego ryzyka: NIE udostepniaj danych uwierzytelniajacych (tokenow, certyfikatow, kluczy), NIE konfiguruj zmiennych srodowiskowych (`KSEF_TOKEN`, `KSEF_ENCRYPTION_KEY`), NIE zezwalaj na autonomiczne uzycie.\n3. **Zweryfikuj izolacje zmiennych srodowiskowych** — potwierdz, ze platforma izoluje env vars i nie loguje\u002Fwyswietla ich wartosci w konwersacji.\n4. **Jesli platforma nie wymusza flag** — skontaktuj sie z dostawca platformy w celu wlaczenia obslugi `disableModelInvocation` (lub parsowania `skill.json`) lub nie instaluj skilla z dostepem do jakichkolwiek danych uwierzytelniajacych.\n\n**Gwarancje zalezne od platformy:**\n- Wymuszanie flagi `disableModelInvocation` zalezy od platformy hostingowej. Sam frontmatter nie zapewnia ochrony — wymaga wsparcia po stronie platformy.\n- Izolacja zmiennych srodowiskowych (env vars) zalezy od platformy. Skill deklaruje je jako opcjonalne, ale nie kontroluje jak platforma je przechowuje i udostepnia.\n- Jesli platforma nie wymusza tych ustawien, traktuj skill jako wyzszego ryzyka i nie udostepniaj mu danych uwierzytelniajacych ani dostepu produkcyjnego.\n\n## Ograniczenia\n\n- **Tylko wiedza — brak wykonywania kodu** - Dostarcza wiedze domenowa, wzorce architektoniczne i wskazowki. Wszystkie przyklady kodu (w tym ML\u002FAI) sa edukacyjne i pogladowe. Skill NIE uruchamia modeli ML, NIE wykonuje inferencji, NIE wymaga runtime'ow Python\u002Fsklearn ani zadnych binarek. Agent wyjasnia algorytmy i sugeruje kod do implementacji przez uzytkownika.\n- **Nie jest porada prawna ani podatkowa** - Informacje odzwierciedlaja stan wiedzy na dzien sporadzenia i moga byc nieaktualne. Zawsze zalecaj konsultacje z doradca podatkowym przed wdrozeniem.\n- **AI wspiera, nie decyduje** - Opisy funkcji AI (klasyfikacja kosztow, wykrywanie fraudu, predykcja cash flow) to architektura referencyjna i wzorce implementacyjne. Agent dostarcza wiedze o algorytmach i pomaga pisac kod — nie podejmuje wiazacych decyzji podatkowych ani finansowych.\n- **Wymagane potwierdzenie uzytkownika** - Zawsze wymagaj jawnej zgody uzytkownika przed: blokowaniem platnosci, wysylaniem faktur na produkcyjny KSeF, modyfikacja zapisow ksiegowych lub jakimkolwiek dzialaniem z konsekwencjami finansowymi.\n- **Dane uwierzytelniajace zarzadzane przez uzytkownika** - Tokeny KSeF API, certyfikaty i klucze szyfrowania musza byc dostarczone przez uzytkownika przez zmienne srodowiskowe (zadeklarowane w metadanych: `KSEF_TOKEN`, `KSEF_ENCRYPTION_KEY`, `KSEF_BASE_URL`) lub menedzer sekretow. Skill nigdy nie przechowuje, nie generuje, nie przesyla ani nie prosi o dane uwierzytelniajace niejawnie. **NIGDY nie wklejaj danych uwierzytelniajacych (tokenow, kluczy, certyfikatow) bezposrednio w rozmowie z agentem** — uzyj zmiennych srodowiskowych lub menedzera sekretow platformy. Przyklady uzycia Vault\u002FFernet w dokumentacji referencyjnej to wzorce architektoniczne do implementacji przez uzytkownika.\n- **Uzyj DEMO do testow** - Produkcja (`https:\u002F\u002Fksef.mf.gov.pl`) wystawia prawnie wiazace faktury. Uzyj DEMO (`https:\u002F\u002Fksef-demo.mf.gov.pl`) do developmentu i testow.\n- **Wylaczone autonomiczne wywolanie** - Skill ustawia `disableModelInvocation: true` i `disable-model-invocation: true` w metadanych frontmatter (oba formaty nazewnictwa) oraz w dedykowanym manifescie [`skill.json`](skill.json). Oznacza to, ze model nie powinien wywolywac tego skilla autonomicznie — wymaga jawnej akcji uzytkownika. **UWAGA:** Frontmatter i `skill.json` to deklaracje — nie gwarancje. Wymuszanie zalezy od platformy. Przed uzyciem zweryfikuj, ze metadane rejestru (registry metadata) wyswietlane przez platforme rowniez pokazuja `disable-model-invocation: true`. Jesli platforma pokazuje `not set` lub `false`, flaga nie jest wymuszana i skill moze byc wywolywany autonomicznie (patrz sekcja \"Model bezpieczenstwa\" powyzej).\n\n## Checklist przed instalacja\n\nPrzed instalacja skilla i konfiguracja zmiennych srodowiskowych wykonaj ponizsze kroki:\n\n- [ ] Zweryfikuj metadane rejestru platformy — pole `disable-model-invocation` musi pokazywac `true`\n- [ ] Zweryfikuj, ze platforma odczytala deklaracje env vars z frontmatter lub [`skill.json`](skill.json) — zmienne `KSEF_TOKEN` i `KSEF_ENCRYPTION_KEY` musza byc widoczne jako sekrety (`secret: true`)\n- [ ] Potwierdz, ze platforma izoluje zmienne srodowiskowe (nie loguje, nie wyswietla w konwersacji)\n- [ ] Przetestuj skill wylacznie ze srodowiskiem DEMO (`https:\u002F\u002Fksef-demo.mf.gov.pl`) przed jakimkolwiek uzyciem produkcyjnym\n- [ ] NIE wklejaj tokenow, kluczy ani certyfikatow bezposrednio w rozmowie — uzyj env vars lub menedzera sekretow\n- [ ] Jesli metadane rejestru nie pasuja do frontmatter\u002Fskill.json — NIE konfiguruj danych uwierzytelniajacych i zglos problem dostawcy platformy\n\n## Glowne kompetencje\n\n### 1. Obsluga KSeF 2.0 API\n\nWystawianie faktur FA(3), pobieranie faktur zakupowych, zarzadzanie sesjami\u002Ftokenami, obsluga trybu Offline24 (awaryjny), pobieranie UPO (Urzedowe Poswiadczenie Odbioru).\n\nKluczowe endpointy:\n```http\nPOST \u002Fapi\u002Fonline\u002FSession\u002FInitToken     # Inicjalizacja sesji\nPOST \u002Fapi\u002Fonline\u002FInvoice\u002FSend          # Wyslanie faktury\nGET  \u002Fapi\u002Fonline\u002FInvoice\u002FStatus\u002F{ref}  # Sprawdzenie statusu\nPOST \u002Fapi\u002Fonline\u002FQuery\u002FInvoice\u002FSync    # Zapytanie o faktury zakupowe\n```\n\nZobacz [references\u002Fksef-api-reference.md](references\u002Fksef-api-reference.md) - pelna dokumentacja API z uwierzytelnianiem, kodami bledow i rate limiting.\n\n### 2. Struktura FA(3)\n\nRoznice FA(3) vs FA(2): zalaczniki do faktur, typ kontrahenta PRACOWNIK, rozszerzone formaty konta bankowego, limit 50 000 pozycji w korekcie, identyfikatory JST i grup VAT.\n\nZobacz [references\u002Fksef-fa3-examples.md](references\u002Fksef-fa3-examples.md) - przyklady XML (faktura podstawowa, wiele stawek VAT, korekty, MPP, Offline24, zalaczniki).\n\n### 3. Przeplywy ksiegowe\n\n**Sprzedaz:** Dane -> Generuj FA(3) -> Wyslij KSeF -> Pobierz nr KSeF -> Ksieguj\n`Wn 300 (Rozrachunki) | Ma 700 (Sprzedaz) + Ma 220 (VAT nalezny)`\n\n**Zakupy:** Odpytuj KSeF -> Pobierz XML -> Klasyfikuj AI -> Ksieguj\n`Wn 400-500 (Koszty) + Wn 221 (VAT) | Ma 201 (Rozrachunki)`\n\nZobacz [references\u002Fksef-accounting-workflows.md](references\u002Fksef-accounting-workflows.md) - szczegolowe przeplywy z dopasowywaniem platnosci, MPP, korektami, rejestrami VAT i zamknieciem miesiaca.\n\n### 4. Funkcje wspomagane AI (architektura referencyjna)\n\nPonizsze opisy to wzorce implementacyjne i architektura referencyjna. Skill NIE uruchamia modeli ML — dostarcza wiedze o algorytmach, pomaga projektowac pipeline'y i pisac kod do implementacji w systemie uzytkownika. Przyklady kodu w plikach referencyjnych (Python, sklearn, pandas) to pseudokod pogladowy — skill nie zawiera wytrenowanych modeli, artefaktow ML ani plikow wykonywalnych.\n\n- **Klasyfikacja kosztow** - Wzorzec: historia kontrahenta -> dopasowanie slow kluczowych -> model ML (Random Forest). Flaguj do przegladu jesli confidence \u003C 0.8.\n- **Wykrywanie fraudu** - Wzorzec: Isolation Forest dla anomalii kwotowych, scoring dla phishing invoices, analiza grafow dla VAT carousel.\n- **Predykcja cash flow** - Wzorzec: Random Forest Regressor na podstawie historii kontrahenta, kwot i wzorcow sezonowych.\n\nZobacz [references\u002Fksef-ai-features.md](references\u002Fksef-ai-features.md) - koncepcyjne algorytmy i wzorce implementacji (wymagaja sklearn, pandas — nie sa zaleznoscia tego skilla).\n\n### 5. Compliance i bezpieczenstwo (wzorce implementacyjne)\n\nPonizsze to rekomendowane wzorce bezpieczenstwa do implementacji w systemie uzytkownika. Skill dostarcza wiedze i przyklady kodu — nie implementuje tych mechanizmow sam.\n\n- Weryfikacja Bialej Listy VAT przed platnosciami\n- Szyfrowane przechowywanie tokenow (wzorce Fernet\u002FVault — do implementacji przez uzytkownika)\n- Audit trail wszystkich operacji\n- Strategia backup 3-2-1\n- Zgodnosc z RODO (anonimizacja po okresie retencji)\n- RBAC (kontrola dostepu oparta na rolach)\n\nZobacz [references\u002Fksef-security-compliance.md](references\u002Fksef-security-compliance.md) - wzorce implementacji i checklista bezpieczenstwa.\n\n### 6. Faktury korygujace\n\nPobierz oryginal z KSeF -> Utworz korekte FA(3) -> Powiaz z nr KSeF oryginalu -> Wyslij do KSeF -> Ksieguj storno lub roznicowo.\n\n### 7. Rejestry VAT i JPK_V7\n\nGenerowanie rejestrow sprzedazy\u002Fzakupow (Excel\u002FPDF), JPK_V7M (miesieczny), JPK_V7K (kwartalny).\n\n## Troubleshooting - szybka pomoc\n\n| Problem | Przyczyna | Rozwiazanie |\n|---------|-----------|-------------|\n| Faktura odrzucona (400\u002F422) | Nieprawidlowy XML, NIP, data, brak pol | Sprawdz UTF-8, waliduj schemat FA(3), weryfikuj NIP |\n| Timeout API | Awaria KSeF, siec, godziny szczytu | Sprawdz status KSeF, retry z exponential backoff |\n| Nie mozna dopasowac platnosci | Niezgodna kwota, brak danych, split payment | Rozszerzone wyszukiwanie (+\u002F-2%, +\u002F-14 dni), sprawdz MPP |\n\nZobacz [references\u002Fksef-troubleshooting.md](references\u002Fksef-troubleshooting.md) - pelny przewodnik troubleshooting.\n\n## Pliki referencyjne\n\nLaduj w zaleznosci od zadania:\n\n| Plik | Kiedy czytac |\n|------|-------------|\n| [skill.json](skill.json) | Manifest metadanych — flagi bezpieczenstwa, deklaracje env vars, ograniczenia. Zrodlo prawdy dla rejestrow i skanerow. |\n| [ksef-api-reference.md](references\u002Fksef-api-reference.md) | Endpointy KSeF API, uwierzytelnianie, wysylanie\u002Fpobieranie faktur |\n| [ksef-legal-status.md](references\u002Fksef-legal-status.md) | Daty wdrozenia KSeF, wymagania prawne, kary |\n| [ksef-fa3-examples.md](references\u002Fksef-fa3-examples.md) | Tworzenie lub walidacja struktur XML faktur FA(3) |\n| [ksef-accounting-workflows.md](references\u002Fksef-accounting-workflows.md) | Zapisy ksiegowe, dopasowanie platnosci, MPP, korekty, rejestry VAT |\n| [ksef-ai-features.md](references\u002Fksef-ai-features.md) | Klasyfikacja kosztow, wykrywanie fraudu, algorytmy predykcji cash flow |\n| [ksef-security-compliance.md](references\u002Fksef-security-compliance.md) | Biala Lista VAT, bezpieczenstwo tokenow, audit trail, RODO, backup |\n| [ksef-troubleshooting.md](references\u002Fksef-troubleshooting.md) | Bledy API, problemy walidacji, wydajnosc |\n\n## Zasoby oficjalne\n\n- Portal KSeF: https:\u002F\u002Fksef.podatki.gov.pl\n- KSeF DEMO: https:\u002F\u002Fksef-demo.mf.gov.pl\n- KSeF Produkcja: https:\u002F\u002Fksef.mf.gov.pl\n- API Bialej Listy VAT: https:\u002F\u002Fwl-api.mf.gov.pl\n- KSeF Latarnia (status): https:\u002F\u002Fgithub.com\u002FCIRFMF\u002Fksef-latarnia\n",{"env":24,"name":5,"source":33,"license":15,"homepage":34,"description":7,"credential_scope":35,"instruction_only":26,"has_executable_code":20,"allowModelInvocation":20,"disableModelInvocation":26,"disable-model-invocation":26},{"KSEF_TOKEN":25,"KSEF_BASE_URL":28,"KSEF_ENCRYPTION_KEY":31},{"secret":26,"required":20,"description":27},true,"Token API KSeF do uwierzytelniania sesji. Dostarczany przez uzytkownika — skill nie generuje, nie przechowuje ani nie przesyla tokenow. Konfiguruj TYLKO po zweryfikowaniu, ze platforma wymusza flage disableModelInvocation (patrz sekcja Model bezpieczenstwa i skill.json).",{"default":29,"required":20,"description":30},"https:\u002F\u002Fksef-demo.mf.gov.pl","Bazowy URL API KSeF. Domyslnie https:\u002F\u002Fksef-demo.mf.gov.pl (DEMO). Produkcja: https:\u002F\u002Fksef.mf.gov.pl — wymaga jawnej zgody uzytkownika. Uzywaj produkcji TYLKO po pelnej weryfikacji bezpieczenstwa platformy.",{"secret":26,"required":20,"description":32},"Klucz szyfrowania Fernet do bezpiecznego przechowywania tokenow. Uzycie opcjonalne — przyklad wzorca bezpieczenstwa opisanego w dokumentacji referencyjnej. Konfiguruj TYLKO po zweryfikowaniu, ze platforma wymusza flage disableModelInvocation.","https:\u002F\u002Fgithub.com\u002Falexwoo-awso\u002Fskills\u002Ftree\u002Fmain\u002Fksef-accountant-pl","https:\u002F\u002Fgithub.com\u002Falexwoo-awso\u002Fskills","optional-user-provided","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fk\u002Fksef-accountant-pl",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":26},[47,50,53],{"tool":48,"command":49},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill ksef-accountant-pl",{"tool":51,"command":52},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill ksef-accountant-pl",{"tool":54,"command":55},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill ksef-accountant-pl","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fk\u002Fksef-accountant-pl\u002FSKILL.md",[],[59,66,73,80,87,94],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]