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

# `.listSkills()`

Agent 수준 기술과 작업 영역 기술을 모두 포함하여 Agent가 사용할 수 있는 모든 기술에 대한 메타데이터를 반환합니다.

## 사용예

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

const skills = await agent.listSkills()

for (const skill of skills) {
  console.log(`${skill.name}: ${skill.description}`)
}
```

## 매개변수

**options** (`object`): Skill 확인을 위한 옵션입니다.

**options.requestContext** (`RequestContext`): 동적 Skill resolver에 전달되는 요청 컨텍스트입니다.

## 반환 값

보고`Promise<SkillMetadata[]>`.

각 항목에는 검색된 기술에 대한 메타데이터가 포함되어 있습니다.

```typescript
interface SkillMetadata {
  name: string
  description: 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>
}
```

## 병합 동작

Agent 수준 Skill과 Workspace 수준 Skill이 모두 구성된 경우 `.listSkills()`는 병합된 세트를 반환합니다. 이름이 충돌하면 Agent 수준 Skill이 우선합니다. 양쪽 모두 `code-review`라는 Skill을 정의한 경우 Agent 수준 버전만 반환됩니다.

## 관련된

- [Agent 기술](https://mastra.zisheng.pro/ko/docs/agents/skills)
- [`.getSkill()`참조](https://mastra.zisheng.pro/ko/reference/agents/getSkill)
- [`createSkill()`참조](https://mastra.zisheng.pro/ko/reference/agents/createSkill)