> For the complete documentation index, see [llms.txt](https://docs.pokeb.ag/data-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pokeb.ag/data-sdk/v2.x.x/core-methods/getskills.md).

# getSkills

`getSkills` allows the retrieval of data for all skills (also known as special abilities), or for a subset of skills.

## Examples

### Get All Skills

`getSkills` will return data for *all skills* if not given any options.

```javascript
import { getSkills } from '@pokebag/data-sdk'

async function getAllSkills() {
  const skills = await getSkills()

  console.log(skills)
}

getAllSkills()
// Logs an array with data for all skills
```

### Get Specific Skills

`getSkills` accepts an `options` object, which supports an `ids` array. This array can be used to filter the results if you're only looking for specific skills.

```javascript
import { getSkills } from '@pokebag/data-sdk'

async function getSomeSkills() {
  const skills = await getSkills({
    ids: [
      'absol-night-slash+',
      'absol-psycho-cut+',
    ],
  })

  console.log(skills)
}

getSomeSkills()
// Logs an array that only includes Absol's Night Slash+ and Psycho Cut+ skills.
```

### Get Skills for a Specific Pokémon

`getSkills` also supports an `options.pokemonIDs` array. This array will filter results by the Pokémon to whom the skill belongs.

***NOTE:*** `options.ids` and `options.pokemonIDs` may not be used together. If you attempt to provide both options, an error will be thrown. If you are looking for an intersection of this data, you will need to filter the lists yourself.

```javascript
import { getSkills } from '@pokebag/data-sdk'

async function getSpecificSkills() {
  const skills = await getSkills({
    pokemonIDs: [
      'crustle',
      'pikachu',
    ],
  })

  console.log(skills)
}

getSpecificSkills()
// Logs an array  with keys representing the pokemon in the `pokemonIDs` array,
// the values of which will includes all ofthe skills for each requested Pokémon
```

## Options

| Option       | Required | Default     | Description                                          |
| ------------ | -------- | ----------- | ---------------------------------------------------- |
| `ids`        | no       | `undefined` | An array of skill IDs to be retrieved.               |
| `pokemonIDs` | no       | `undefined` | An array of Pokémon IDs to filter the skill results. |
| `patch`      | no       | `'latest'`  | The maximum patch version to return data for.        |