> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dev.gojinko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Prebuilt prompts + workflows that make coding agents better at using Jinko.

Skills are packaged prompts + instructions for coding agents (Claude Code, Codex, Openclaw, Cursor). They tell the agent:

* Which Jinko tools exist and how they compose
* What the canonical booking flow looks like
* What NOT to do (e.g., never fabricate traveler data)
* Common pitfalls and how to recover

Think of a skill as a runbook the agent auto-consults when you ask it to do something travel-related.

## Available skills

| Skill                                      | Clients                                        | Source                                                                           |
| ------------------------------------------ | ---------------------------------------------- | -------------------------------------------------------------------------------- |
| **`@gojinko/plugin`** (bundle of 6 skills) | Claude Code (as a plugin), Codex (as a plugin) | [npm](https://www.npmjs.com/package/@gojinko/plugin)                             |
| **jinko-flight** (Openclaw)                | Openclaw                                       | [clawhub.ai/kevinjinko/jinko-flight](https://clawhub.ai/kevinjinko/jinko-flight) |

### What's inside `@gojinko/plugin`

| Skill            | What it teaches the agent                                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `search-flights` | Discovery: when to use `find_destination`, `flight_calendar`, `flight_search` (cached vs. live, route+dates vs. inspiration) |
| `search-hotels`  | Live hotel search by destination + dates + occupancy. Filters, room composition, `htl_*` offer tokens for booking            |
| `book-trip`      | Canonical end-to-end flow: search → `trip(add_item)` → travelers → ancillaries → `book`. Multi-domain (flight + hotel) carts |
| `manage-booking` | Post-booking: `get_booking`, refund check/commit/status, exchange shop/price/commit/status                                   |
| `account`        | Auth status, API key handling, common credential pitfalls                                                                    |
| `jinko-cli`      | The CLI as an agent surface (mirrors the MCP tools as `jinko` shell commands)                                                |

## Install (Claude Code)

```bash theme={null}
# The plugin bundles the skill + sample scripts
claude plugin add @gojinko/plugin
```

Claude Code picks up the skill automatically. First time you ask it a travel question it'll propose the Jinko flow.

## Install (Codex)

```bash theme={null}
codex plugin add @gojinko/plugin
```

The plugin ships with both Claude and Codex skill manifests so you install it once.

## Install (Openclaw)

Via the Clawhub UI: [clawhub.ai/kevinjinko/jinko-flight](https://clawhub.ai/kevinjinko/jinko-flight) → **Install**. The skill is bundled with a curated prompt.

## When to use a skill

| Situation                                                            | Skill helps?                                                                            |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| You want an agent to book a trip via CLI without hand-holding        | Yes, the skill knows the 8-step flow                                                    |
| You're building your own MCP agent and want Jinko-specific prompting | Yes, import the skill's markdown as your system prompt                                  |
| You're calling the SDK directly from your own code                   | No, use the [SDK docs](/connect/sdk) and [Flight booking guide](/guides/flight-booking) |
| You want a chat agent to just "find me a flight"                     | No, MCP OAuth is enough, no skill needed                                                |

Skills are for **coding agents**. Consumer-facing conversational agents (Claude Desktop, ChatGPT) work great with just the MCP endpoint + OAuth.

## Writing your own

The existing skills are plain markdown with a small YAML preamble. Copy one and edit:

* **Claude Code plugins**: [plugin repo](https://github.com/jinkoso/jinko-dev-tools/tree/main/packages/plugin/skills)
* **Codex plugins**: same repo, parallel folder

Make a PR if you write a skill for a client we don't yet support, we'll list it here.

## Want more?

Jinko Discord has a `#skills` channel where the community shares custom skills and prompts. Email [dev@gojinko.com](mailto:dev@gojinko.com) for the invite.