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

# Developer API Overview

> Allow other Bukkit/Paper plugins to read and modify Skills player data via the SkillsAPI interface.

The Skills plugin exposes a public Java/Kotlin API that other Bukkit or Paper plugins can use to read and manipulate player skill data at runtime. The API is registered through Bukkit's built-in `ServicesManager`, so no direct dependency on the Skills plugin classes is required beyond the interface.

## What the API provides

| Category            | Capabilities                                                                 |
| ------------------- | ---------------------------------------------------------------------------- |
| Skill CRUD          | Get, set, add, and check skill values for any online player                  |
| Stat access         | Read the derived STR, DEX, and INT stats calculated from skill totals        |
| HP / Mana / Stamina | Read current and maximum values; restore mana or stamina programmatically    |
| Utility             | List all valid skill names, validate a skill name, retrieve a player's title |

## Availability

The API was introduced in **Skills v0.4.13**. It is registered when the plugin enables and unregistered when it disables. If Skills is loaded as a soft dependency, always null-check the provider before calling any methods.

<Columns cols={2}>
  <Card title="Getting started" icon="rocket" href="/api/getting-started">
    Add Skills as a dependency, obtain the API instance, and run your first queries.
  </Card>

  <Card title="API reference" icon="book" href="/api/skills-api-reference">
    Full documentation for all 19 methods in the SkillsAPI interface.
  </Card>
</Columns>