# docyrus-api-dev

This skill guides Docyrus API integration with OAuth2, data-source requests, query payloads, and external connectors. Use it while building a Docyrus-backed app.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 824 installs · ★ 13
- Author: Docyrus
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Docyrus/agent-skills/tree/HEAD/skills/docyrus-api-dev/SKILL.md
- Updated: 2026-09-26
- HTML: https://affpapa.org/en/nevibecode/skills/docyrus-api-dev

## What it does

docyrus-api-dev covers `@docyrus/api-client` and `@docyrus/signin`. It shows how a React app can use the sign-in provider with OAuth2 PKCE, while other applications can work with `OAuth2Client` directly. It also covers creating a REST client and refreshing access tokens.

The skill addresses requests for users, actions, and tenant data sources, including payloads with filters, aggregations, formulas, pivots, and child queries. Connector workflows include discovery, action inspection, and requests made with provider authentication. Tenant data-source endpoints work only when that source exists in the tenant, so this constraint affects the integration design.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Docyrus/agent-skills --skill docyrus-api-dev -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/docyrus-api-dev/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/docyrus-api-dev/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Docyrus/agent-skills --skill docyrus-api-dev -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/docyrus-api-dev/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Docyrus/agent-skills --skill docyrus-api-dev -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/docyrus-api-dev/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Docyrus/agent-skills docyrus-api-dev
```

2. **Manually: put the files in place**
- File: `.github/skills/docyrus-api-dev/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Docyrus/agent-skills --skill docyrus-api-dev -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Docyrus/agent-skills --path skills/docyrus-api-dev
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/docyrus-api-dev/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Docyrus/agent-skills --skill docyrus-api-dev -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Docyrus/agent-skills/tree/HEAD/skills/docyrus-api-dev/SKILL.md

## When to use it
- add OAuth2 authentication to a Docyrus application
- call Docyrus data-source REST endpoints
- build payloads for filtered and aggregated queries
- discover connectors and run external actions

## Example prompts
- Connect this React app to Docyrus with `@docyrus/signin` and OAuth2 PKCE.
- Build a Docyrus data-source request with filters, aggregations, and a child query.
- Show how to send a request through a connector using provider authentication.

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md