---
title: "Skills hooks"
description: "Hand-written shim. Implementation is generated; see ./skills.gen."
section: "Libraries"
group: "React hooks"
order: 446
---

## Hooks

### `useCreateSkill` `mutation`

Create a new skill.

```ts
useCreateSkill(options?: MutationOpts<Skill, CreateSkillParams>)
```

**Types:** [Skill](/types/skill) · [CreateSkillParams](/types/create-skill-params)

### `useDeleteSkill` `mutation`

Soft-delete a skill.

```ts
useDeleteSkill(options?: MutationOpts<SuccessResponse, string>)
```

**Types:** [SuccessResponse](/types/success-response)

### `useListSkills` `query`

List skills with pagination and optional filtering.

```ts
useListSkills(params?: Omit<ListSkillsParams, | > & { filter?: SkillFilter; orderBy?: SkillOrderBy[]; } & SkillShorthands, options?: QueryOpts<Page<Skill>>)
```

**Types:** [ListSkillsParams](/types/list-skills-params) · [SkillFilter](/types/skill-filter) · [SkillOrderBy](/types/skill-order-by) · [SkillShorthands](/types/skill-shorthands) · [Page](/types/page) · [Skill](/types/skill)

### `usePurgeSkill` `composite`

Permanently delete a soft-deleted skill.

```ts
usePurgeSkill(options?: MutationOpts<SuccessResponse, PurgeSkillParams>)
```

**Types:** [SuccessResponse](/types/success-response) · [PurgeSkillParams](/types/purge-skill-params)

### `useRestoreSkill` `composite`

Restore a soft-deleted skill.

```ts
useRestoreSkill(options?: MutationOpts<Skill, string>)
```

**Types:** [Skill](/types/skill)

### `useRetrieveSkill` `query`

Get a single skill by ID.

```ts
useRetrieveSkill(id: string, options?: QueryOpts<Skill>)
```

**Types:** [Skill](/types/skill)

### `useUpdateSkill` `mutation`

Update a skill.

```ts
useUpdateSkill(options?: MutationOpts<Skill, UpdateSkillParams>)
```

**Types:** [Skill](/types/skill) · [UpdateSkillParams](/types/update-skill-params)