Umiejętność Claude

Umiejętność Claude (Claude Skill) to plik konfiguracyjny, który uczy Claude jak prawidłowo korzystać z API Ogarni.AI. Dzięki niemu Claude zna dostępne endpointy, format uwierzytelniania, limity zapytań i najlepsze praktyki — bez konieczności wyjaśniania tego za każdym razem.

Czym jest Claude Skill?

Claude Skill to mechanizm Claude Code pozwalający na definiowanie specjalistycznej wiedzy w plikach Markdown. Gdy umiejętność jest załadowana, Claude automatycznie wie jak wykonywać określone zadania.

Umiejętność ogarniai-api zawiera:

• Uwierzytelnianie — format tokenu oai_, nagłówek X-API-Key
• Endpointy — pełna lista ponad 20 endpointów z parametrami i schematami odpowiedzi
• Limity zapytań — limity per scope (1000/h read, 2000/h write, 5000/h admin)
• Obsługa błędów — kody statusów, format odpowiedzi błędu
• Przykłady kodu — gotowe fragmenty w curl, Python i JavaScript

Lokalizacja

Umiejętność znajduje się w katalogu:

.claude/skills/ogarniai-api/
├── SKILL.md                      # Główny plik umiejętności
└── references/
    ├── endpoints.md              # Szczegółowa dokumentacja endpointów
    └── examples.md               # Przykłady kodu

Jak korzystać

Umiejętność jest automatycznie dostępna, gdy pracujesz w repozytorium Ogarni.AI z Claude Code. Nie wymaga dodatkowej konfiguracji.

Możesz po prostu pisać polecenia takie jak:

• “Napisz skrypt w Pythonie, który pobiera moje wydatki z ostatniego miesiąca”
• “Zrób zapytanie curl do API po listę kategorii”
• “Dodaj obsługę rate limitów do istniejącego klienta API”

Claude automatycznie użyje wiedzy z umiejętności, aby wygenerować poprawny kod z prawidłowym uwierzytelnianiem i obsługą błędów.

Instalacja globalna

Jeśli chcesz mieć dostęp do wiedzy o API Ogarni.AI we wszystkich projektach, możesz zainstalować umiejętność globalnie:

# Sklonuj repozytorium umiejętności do globalnego katalogu
cd ~/.claude/skills
git clone --depth 1 https://github.com/IsidoreSoftware/ogarniai-claude-skill.git ogarniai-api

Alternatywnie możesz pobrać pliki ręcznie:

1. Utwórz katalog ~/.claude/skills/ogarniai-api/
2. Pobierz plik SKILL.md oraz katalog references
3. Umieść je w utworzonym katalogu

Umiejętność będzie wtedy dostępna we wszystkich projektach podczas pracy z Claude Code.

Umiejętność a serwer MCP

Cecha	Umiejętność Claude	Serwer MCP
Działanie	Claude generuje kod na podstawie wiedzy	Claude wywołuje narzędzia w czasie rzeczywistym
Dostęp do danych	Pośredni (przez wygenerowany kod)	Bezpośredni (dane w konwersacji)
Wymagania	Repozytorium Ogarni.AI	Token API + konfiguracja MCP
Zastosowanie	Pisanie skryptów, integracji, dokumentacji	Interaktywna analiza danych finansowych

Oba podejścia się uzupełniają — umiejętność pomaga pisać kod, a serwer MCP daje bezpośredni dostęp do danych.