---
name: niezbednik-skills
description: >-
  Finds and recommends AI skills (Agent Skills, SKILL.md) and apps from Niezbędnik,
  a Polish catalog at niezbednik.app. Use when the user asks "is there a skill for...",
  "czy jest skill do...", "jaki skill do...", wants a skill or an app for a task
  (invoices and KSeF, documents, tests, design, notes, databases...) or asks what to
  add to Claude, ChatGPT, Claude Code, Cursor or Codex. Never installs anything
  without the user's explicit consent.
license: MIT
metadata:
  author: niezbednik.app
  version: "1.0"
---

# Pick a tool from Niezbędnik

Niezbędnik (https://niezbednik.app) is a Polish catalog of apps and AI skills with descriptions in Polish. Use it to suggest skills and apps that fit the user's task. You only recommend. The user decides what to install.

## Sources

Always fetch fresh data. Do not answer from memory.

- Skills (JSON): `https://niezbednik.app/skills/index.json`
- Skills (text, if JSON is a problem): `https://niezbednik.app/skills/llms.txt`
- Apps: `https://niezbednik.app/api/content?type=tools&limit=100&page=1`, then `page=2` and so on, up to `pagination.totalPages`

If you cannot fetch these addresses (no web access), say so and give the user the address `https://niezbednik.app/skills`, so they can browse it themselves.

## Steps

1. Understand the task. If it is unclear, ask one short question.
2. Fetch the skills index. Pick 1-3 skills that clearly fit, using `description`, `category`, `examples` and `tools`. Fewer good matches beat a long list. If nothing fits, say so plainly.
3. If an app would help with the task (not only a skill), fetch the apps catalog and pick up to 3 apps. Apps related to a skill are also listed in `skills[].tools`.
4. For each skill, show:
   - `title` and `name`, plus one sentence on what it is for,
   - `license` and `author`,
   - the card link (`url`),
   - the install command for the user's agent from `install` (`claudeCode`, `cursor`, `codex`, `geminiCli`, `copilot`, `skillsCli`). For Claude.ai and ChatGPT give the `zip` link and say it is uploaded in Claude.ai under Customize → Skills and in ChatGPT under Plugins → Skills. When `zip` is empty (`mode: link`), point to `source.url`,
   - a warning when `hasScripts` is true: the skill contains scripts, so the user should check what they do before installing.
5. For each app, show the title, one sentence from `description` and the card link (`https://niezbednik.app/tools/<slug>`).
6. Ask whether to install anything. Do nothing until the user clearly agrees.
7. After consent: show the user the skill's SKILL.md (the `skillMd` link or `source.url`) and, if you can run commands, run exactly the install command from the index. Do not run any scripts from the skill during installation.

## Links and honesty

- Always give the Niezbędnik card link first.
- An app entry may have `shortLink` (an address on `niezbednik.link`). These are Niezbędnik short links and some of them are affiliate links. If you give such an address, label it: "(skrót Niezbędnika, może być linkiem partnerskim)". Never present a `niezbednik.link` address without this label.
- Do not call any other link an affiliate link, and do not claim that a given short link is an affiliate link for sure.
- Do not invent skills, licenses, commands or prices. Use only data from the catalog. If something is missing, say so.

## Answer format

Answer in the user's language (Polish users get Polish). Keep it short, for example:

```
1. ksef-invoice: KSeF: faktura FA(3) z PDF-a
   Do czego: zamienia fakturę z PDF-a albo opisu w plik XML FA(3) do KSeF.
   Licencja: Apache-2.0 (autor: ksefuj.to)
   Karta: https://niezbednik.app/skills/ksef-invoice
   Claude Code: /plugin marketplace add ksefuj/skills
   Claude.ai i ChatGPT: https://niezbednik.app/skills/ksef-invoice/skill.zip

Pasujące aplikacje:
- Fakturownia: https://niezbednik.app/tools/fakturownia
  https://niezbednik.link/fakturownia (skrót Niezbędnika, może być linkiem partnerskim)

Zainstalować któryś z nich?
```
