# Agent skill

A coding agent should not have to read a website to integrate an API. This is the whole reference packaged the way agents actually consume instructions: a `SKILL.md` with the rules, and a `references/` folder with every page of this documentation as Markdown, plus the OpenAPI document.

Drop it in and the agent knows the base URL, the header, the scopes, the paging contract, the error codes, the retry rules, and every endpoint with its parameters.

## Download

The bundle is a zip. Unpack it into your agent's skills directory: `.claude/skills/` for Claude Code, or wherever your tool loads skills from.

[Download baba-news-api-skill.zip](/api/developers/skill)

```bash Install
curl -L -o baba-news-api.zip https://news.itsbaba.com/api/developers/skill
unzip baba-news-api.zip -d .claude/skills/
```

## What is inside

| File | What it is |
| --- | --- |
| `baba-news-api/SKILL.md` | The entry point: what the API is, the one header, the envelope, the endpoint index, and the rules that keep an integration correct. |
| `baba-news-api/references/*.md` | Every page of this documentation, unchanged. |
| `baba-news-api/references/openapi.json` | The OpenAPI 3.1 document, for code generation. |

## Reading the docs as Markdown

Every page here is also served as raw Markdown, at `/api/developers/docs/<page>.md`. The page URL with `.md` on the end redirects to it, so `curl -L` on either one works:

```bash Raw Markdown
curl https://news.itsbaba.com/api/developers/docs/authentication.md
curl https://news.itsbaba.com/api/developers/docs/endpoints.md
```

That is the same text the skill bundles, so an agent that prefers to fetch rather than install gets an identical answer.