Claude Skill

The Ogarni.AI Claude skill is a set of reference files that teach Claude (and other LLMs using Claude Code) how to interact with the Ogarni.AI API. It is designed to be auto-loaded when working within the repository, so there is no manual setup required.

What is a Claude skill?

A Claude skill is a structured knowledge file stored in a .claude/skills/ directory. When Claude Code detects a skill that matches the user’s query, it automatically loads the relevant context. This means Claude already knows how to authenticate, which endpoints are available, what the rate limits are, and how to write code that uses the API.

Where to find it

The skill is located in the repository at:

.claude/skills/ogarniai-api/
├── SKILL.md                     # Main skill definition and overview
└── references/
    ├── endpoints.md             # Complete endpoint reference with schemas
    └── examples.md              # Code examples in curl, Python, and JavaScript

What it covers

The skill provides Claude with knowledge about:

Authentication — How to use the X-API-Key header, token format (oai_ prefix), and available scopes (read, write, admin).
Endpoints — All 20+ read-only API endpoints with their parameters, response schemas, and example responses.
Rate limits — Per-scope hourly limits (1,000 / 2,000 / 5,000), rate limit headers, and retry strategies.
Error handling — JSON error format, HTTP status codes, and how to handle common errors.
Code examples — Ready-to-use client code in curl, Python, and JavaScript with rate limit awareness.
MCP server — How the MCP server wraps API endpoints as tools for LLM integration.

How to use it

The skill is auto-loaded when you work in the Ogarni.AI repository with Claude Code. Simply ask Claude a question related to the API:

“How do I authenticate with the Ogarni.AI API?”
“Write a Python script that lists my recent receipts.”
“What parameters does the summaries endpoint accept?”
“Help me handle rate limits in my integration.”

Claude will use the skill’s reference files to provide accurate, up-to-date answers based on the actual API specification.

Global installation

If you want Claude to have access to the Ogarni.AI API knowledge in all your projects, you can install it globally:

# Clone the skill repository into your global skills directory
cd ~/.claude/skills
git clone --depth 1 https://github.com/IsidoreSoftware/ogarniai-claude-skill.git ogarniai-api

Alternatively, you can manually download the files:

Create ~/.claude/skills/ogarniai-api/
Download the SKILL.md and references files
Place them in the directory

The skill will then be available in all your projects when working with Claude Code.