Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

api-skill

/api-skill

Zamienia REST API w skill dla agenta zamiast serwera MCP i pomaga wybrać między nimi dla danego API.

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

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

Zamienia REST API w skill dla agenta zamiast serwera MCP i pomaga wybrać między nimi dla danego API.

Wyzwalacze z opisu

wrap
Oryginalny opis (EN)

Turn a REST API into an agent skill instead of an MCP server. Use when asked to give an agent access to an API, to "wrap" an API, or to decide between a skill and an MCP server for one.

Jak działa

  1. Skill or MCP server
  2. Steps
  3. Example: ABS Data API (no key)
  4. Example: ABN Lookup (free key)
Sekcje z nagłówków SKILL.md, w oryginale · 67 linii, 489 słów
Podgląd SKILL.md
---
name: api-skill
description: Turn a REST API into an agent skill instead of an MCP server. Use when asked to give an agent access to an API, to "wrap" an API, or to decide between a skill and an MCP server for one.
---

# Turn an API into a skill

Most APIs an agent needs are a few calls and one key. A skill covers that with a page of instructions. Build an MCP server only when the job outgrows the page.

## Skill or MCP server

Build a skill when:
- the agent uses a handful of endpoints;
- it signs in with one key, or none;
- each call stands alone, with no session to keep;
- one person or one team uses it.

Build an MCP server when:
- each user signs in with their own account (OAuth);
- there are many tools, or long-running and streaming calls;
- several agents or apps share it and need separate permissions.

Start with a skill. Move to an MCP server when the instructions pass about a page, or users need their own sign-in.

## Steps

1. Read the official API docs. Note the base URL, how it signs in, rate limits and terms of use.
2. Keep the key in an environment variable or the user's secret store. It never goes in the skill file, a prompt or a chat.
3. Write `SKILL.md`:
   - frontmatter with a `name` and a `description` that names the words a user would say;
   - what the API gives, in one line;
   - how it signs in and which variable holds the key;
   - the three to five calls the agent will actually make, each with an example request and the response fields to read;
   - limits, error codes and what to do on each;
   - what not to do: writes, deletes or spend without a human's yes.
4. Add a short script under `scripts/` only when requests need signing, paging or parsing.
5. Run each example once, read-only, and write the date you checked it in the skill.
6. List the API in Gearlist with its access notes.

## Example: ABS Data API (no key)

Free and open without a key since 29 November 2024. Responses are SDMX, so ask for JSON or CSV in the Accept header.

```bash
# List the datasets (dataflows) the ABS publishes
curl -s -H "Accept: application/vnd.sdmx.structure+json" \
  "https://data.api.abs.gov.au/rest/dataflow/ABS?detail=allstubs"

# The latest Consumer Price Index figures as CSV
curl -s -H "Accept: application/vnd.sdmx.data+csv" \
  "https://data.api.abs.gov.au/rest/data/ABS,CPI/all?lastNObservations=1"
```

Read `data.dataflows[].id` and `.name` from the first call to pick a dataset, then swap it in for `CPI`. Replace `all` with a key to filter by measure or region; the ABS Data API user guide explains the key format.

## Example: ABN Lookup (free key)

Register on the ABN Lookup web services page to receive a GUID by email, then keep it in `ABR_GUID`.

```bash
# One ABN's registered details
curl -s "https://abr.business.gov.au/json/AbnDetails.aspx?abn=${ABN}&guid=${ABR_GUID}&callback=c"

# Businesses matching a name
curl -s "https://abr.business.gov.au/json/MatchingNames.aspx?name=${NAME}&maxResults=10&guid=${ABR_GUID}&callback=c"
```

The JSON comes wrapped in `c(...)`, so strip the wrapper before parsing. Read `EntityName`, `AbnStatus`, `BusinessName` and `AddressState`. An empty `Abn` means not found or a bad GUID.

Checked 3 November 2026.

Wersje

W bazie nie ma innych skilli o nazwie api-skill.

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

  • 100agent-toolkit
    Znajduje, uruchamia i łączy narzędzia CLI tk zamiast serwera MCP lub jednorazowego skryptu, na przykład do API lub CI.
  • 90custom-agents
    Pomaga budować własnego agenta lub automatyzację w Subscriby, wybrać MCP albo REST API i zabezpieczyć uwierzytelnianie oraz audyt.
  • 90agent-tools-dsh
    Szuka zewnętrznego API, serwera MCP lub agenta do zadania, porównuje je pod kątem stanu i jakości oraz sprawdza bezpieczeństwo MCP.
  • 100mcp2cli
    Zamienia dowolny serwer MCP, specyfikację OpenAPI lub endpoint GraphQL w CLI: odkrywanie narzędzi i endpointów, wywoływanie operacji i generowanie nowego skilla z API.
  • 100openapi-to-mcp
    Buduje i wdraża serwer MCP ze specyfikacji OpenAPI lub Swagger przez SDK mcp-use w TypeScript, udostępniając API REST modelom takim jak Claude i ChatGPT.
  • 100rest-api-to-mcp
    Zamienia REST API z OpenAPI na repozytorium serwera MCP albo pakiet skilla z skryptami, gotowe do publikacji na GitHubie.

Uwagi i zgłoszenia

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