> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# `.getSkill()`

Récupère un Skill précis à partir de son nom parmi les Skills configurés pour l’Agent, qu’ils soient définis au niveau de l’Agent ou du Workspace.

## Exemple d’utilisation

```typescript
import { agent } from '../mastra/agents'

const skill = await agent.getSkill('code-review')

if (skill) {
  console.log(skill.name) // "code-review"
  console.log(skill.description) // "Use when reviewing code changes."
  console.log(skill.instructions) // Full markdown instructions
}
```

## Paramètres

**skillName** (`string`): Nom du Skill à récupérer.

**options** (`object`): Options de résolution du Skill.

**options.requestContext** (`RequestContext`): Contexte de requête transmis aux résolveurs dynamiques de Skills.

## Valeur renvoyée

Renvoie `Promise<Skill | null>`.

Renvoie l’objet `Skill` s’il est trouvé, ou `null` s’il n’existe aucun Skill portant ce nom.

```typescript
interface Skill {
  name: string
  description: string
  instructions: string
  path: string
  source: { type: string; projectPath: string }
  references: string[]
  scripts: string[]
  assets: string[]
  license?: string
  compatibility?: string[]
  'user-invocable'?: boolean
  metadata?: Record<string, unknown>
}
```

## Comportement de fusion

Lorsque des Skills sont configurés à la fois au niveau de l’Agent et du Workspace, `.getSkill()` effectue sa recherche dans l’ensemble fusionné. En cas de conflit de noms, les Skills définis au niveau de l’Agent sont prioritaires.

## Voir aussi

- [Skills des Agents](https://mastra.zisheng.pro/fr/docs/agents/skills)
- [Référence de `.listSkills()`](https://mastra.zisheng.pro/fr/reference/agents/listSkills)
- [Référence de `createSkill()`](https://mastra.zisheng.pro/fr/reference/agents/createSkill)