본문으로 건너뛰기

.listSkills()

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

사용예
사용예에 대한 직접 링크

src/routes/skills.ts
import { agent } from '../mastra/agents'

const skills = await agent.listSkills()

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

매개변수
매개변수에 대한 직접 링크

options?:

object
Skill 확인을 위한 옵션입니다.
object

requestContext?:

RequestContext
동적 Skill resolver에 전달되는 요청 컨텍스트입니다.

반환 값
반환 값에 대한 직접 링크

보고Promise<SkillMetadata[]>.

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

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 수준 버전만 반환됩니다.