# Dzaleka Online Services API Skill

This repository contains an **Agent Skill** for interacting with the **Dzaleka Online Services API**. It allows AI agents to fetch community data (services, events, jobs, news) and search across collections.

## Overview

- **Name:** `dzaleka-online-services-api`
- **Version:** 1.0.0
- **License:** MIT

## Structure

- **[SKILL.md](dzaleka-online-services-api/SKILL.md):** The main entry point containing instructions for AI agents.
- **[references/](dzaleka-online-services-api/references/):** detailed documentation for endpoints, schemas, and schemas.
    - `endpoints.md`: List of verified API endpoints.
    - `schemas.md`: JSON data structures for resources.
    - `errors.md`: Error handling and status codes.
    - `usage-patterns.md`: Best practices and anti-patterns.

## Usage

Agents compatible with the [Agent Skills](https://agentskills.io) specification can use this skill to programmatically access Dzaleka Online Services data.

### Example Capabilities
- "Find education services in Dzaleka"
- "List upcoming cultural events"
- "Search for jobs in the medical field"
- "Get the latest community news"

## Installation

You can install this skill directly using the `skills` CLI:

```bash
npx skills add Dzaleka-Connect/dzaleka-api-skills
```

Or register it manually in Claude Code as a local marketplace (see below).

## Registration

You can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:

```bash
/plugin marketplace add .
```

(Ensure you are running the command from the root of this repository)

## API Source
Data is sourced from the public API at `https://services.dzaleka.com/api`.