[LLM] Agent Skills

[์›๋ณธ ๋งํฌ]

Agent Skills๋Š” ์•คํŠธ๋กœํ”ฝ์—์„œ ๊ณต๊ฐœํ•œ ์—์ด์ „ํŠธ ๊ฐœ๋ฐœ์šฉ ์ƒ์‚ฐ์„ฑ ๊ฐ•ํ™” ์ˆ˜๋‹จ์ด๋‹ค.
์‰ฝ๊ฒŒ ๋งํ•ด์„œ, ์—์ด์ „ํŠธ๋ฅผ ์œ„ํ•œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๊ฐ™์€ ๊ฒƒ์ด๋‹ค.

ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ž…๋ ฅ์œผ๋กœ ๋ฐ›์•„์„œ ํŒŒ์›Œํฌ์ธํŠธ๋ฅผ ๋งŒ๋“ ๋‹ค๊ฑฐ๋‚˜ pdf๋ฅผ ์ˆ˜์ •/์ƒ์„ฑํ•œ๋‹ค๊ฑฐ๋‚˜ ํ•˜๋Š” ํŒŒ์ผ ๊ธฐ๋ฐ˜์˜ ํ—ค๋น„ํ•˜๊ฑฐ๋‚˜ ๋ณต์žกํ•  ์ˆ˜ ์žˆ๋Š” ์ž‘์—…๋“ค์„ ๋ชจ๋“ˆ์˜ ํ˜•ํƒœ๋กœ ์ œ๊ณตํ•˜๋Š” ๊ฒƒ์ด ํŠน์ง•์ด๋‹ค.
๋‚ด์„ธ์šฐ๋Š” ์ฃผ์š” ์žฅ์ ์€ ํ† ํฐ ์‚ฌ์šฉ๋Ÿ‰์„ ์ค„์ผ ์ˆ˜ ์žˆ๊ณ , ๊ทœ์น™ ๊ธฐ๋ฐ˜์˜ ์ ์ง„์  ์ฒ˜๋ฆฌ๋ฅผ ์šฉ์ดํ•˜๊ฒŒ ํ•ด์ค€๋‹ค๋Š” ๊ฒƒ์ด๋‹ค.

์•คํŠธ๋กœํ”ฝ์„ ๊ตฌ๋…ํ•ด์•ผ๋งŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ณ , ํ˜„ ์‹œ์ ์—์„œ๋Š” ์•ˆ์ •ํ™”๊ฐ€ ๋˜์ง€ ์•Š์€ ๊ธฐ๋Šฅ์ด๋‹ค. ์•„์ง ๋ฒ ํƒ€ ๋ฒ„์ „์ด๋‹ค.

๊ทธ๋ฆฌ๊ณ  ํŠน์ดํ•˜๊ฒŒ๋„ Skill์— ๋Œ€ํ•œ ์ฒ˜๋ฆฌ ์ž‘์—…์€ ์ผ์ข…์˜ ๊ฐ€์ƒ๋จธ์‹  ์œ„์—์„œ ์‹คํ–‰๋˜๋Š” ๊ตฌ์กฐ๋ฅผ ๊ฐ–๊ณ  ์žˆ๋‹ค.

https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview




ํ”„๋ฆฌ์…‹ Skills ์‚ฌ์šฉํ•ด๋ณด๊ธฐ (with Python)

LLM ํ™˜๊ฒฝ๋“ค์ด ์œผ๋ ˆ ๊ทธ๋ ‡๋“ฏ์ด, ์ด๊ฒƒ๋„ ํ™˜๊ฒฝ์ด Python ์ชฝ์— ๋ชฐ๋นต๋˜์–ด์žˆ๋‹ค.
uv๋ฅผ ์“ด๋‹ค๊ณ  ๊ฐ€์ •ํ•˜๊ฒ ๋‹ค.

skills๋ฅผ ์“ฐ๋ ค๋ฉด ๋‹ค์Œ ์ „์šฉ ๋ชจ๋“ˆ์ด ํ•„์š”ํ•˜๋‹ค.

uv add anthropic

์•คํŠธ๋กœํ”ฝ ํด๋ผ์ด์–ธํŠธ๋ฅผ ํ†ตํ•ด ์•คํŠธ๋กœํ”ฝ์—์„œ ์ง€์›ํ•˜๋Š” skill ๋ชฉ๋ก์„ ์กฐํšŒํ•ด๋ณด์ž.

import anthropic

api_key = "..."

client = anthropic.Anthropic(api_key=api_key)

# List Anthropic-managed Skills
skills = client.beta.skills.list(source="anthropic", betas=["skills-2025-10-02"])

for skill in skills.data:
    print(f"{skill.id}: {skill.display_title}")

ํ˜„ ์‹œ์ ์—์„œ ์ œ๊ณต๋˜๋Š” ์Šคํ‚ฌ ํ”„๋ฆฌ์…‹์€ ๋‹จ 4๊ฐ€์ง€ ๋ฟ์ด๋‹ค.
์ € skill.id(pdf ๋“ฑ)์„ ์‚ฌ์šฉํ•˜๋ฉด ์ € skill์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

๊ฐ„๋‹จํ•œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ง‘์–ด๋„ฃ์–ด์„œ pptx ํŒŒ์ผ์„ ๋งŒ๋“ค์–ด๋ณด์ž.

# Create a message with the PowerPoint Skill
response = client.beta.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    betas=["code-execution-2025-08-25", "skills-2025-10-02"],
    container={
        "skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create a presentation about renewable energy with 5 slides",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

print(response.content)

์ด๋Ÿฐ ์‹์œผ๋กœ ์˜๋ฉด ๋œ๋‹ค.
๋ชจ๋ธ ์ •ํ•˜๊ณ , ํ† ํฐ ์ œํ•œ ๊ฑธ๊ณ , messages๋กœ ์š”๊ตฌ์‚ฌํ•ญ ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ง€์ •ํ•ด์„œ ์‹คํ–‰ํ•˜๋ฉด ๊ทธ๋งŒ์ด๋‹ค.

์‹คํ–‰ ์‹œ๊ฐ„ ์ž์ฒด๋Š” ๊ฝค ์˜ค๋ž˜ ๊ฑธ๋ฆด ์ˆ˜ ์žˆ๋‹ค. ๊ธฐ๋ณธ์ ์œผ๋กœ ๋น ๋ฅด๊ฒŒ ๋˜๋Š” ๊ธฐ๋Šฅ๋“ค์€ ์•„๋‹ˆ๋‹ค.

๊ทธ๋Ÿผ ์ด๋Ÿฐ ์‹์œผ๋กœ ์ถœ๋ ฅ์ด ๋‚˜์˜ฌ ๊ฒƒ์ด๋‹ค.
์ด ๊ฒฝ์šฐ์—๋Š” pptx๊ฐ€ ํƒœ๊ทธ ๊ธฐ๋ฐ˜ ํฌ๋งท์ด๋ผ ์ข€ ์–ด์ง€๋Ÿฝ๊ธด ํ•œ๋ฐ, ์‹ค์ œ๋กœ ์ž˜ ๋งŒ๋“ค์–ด์ง„ ๊ฒƒ์€ ๋งž๋‹ค.




์‚ฌ์šฉ์ž ์ •์˜ Skill

Skill์€ ์‚ฌ์ „ ์ œ๊ณตํ•˜๋Š” ๊ฒƒ ์ด์™ธ์—๋„ ์ง์ ‘ ๋งŒ๋“ค์–ด์„œ ์“ธ ์ˆ˜๋„ ์žˆ๋‹ค.
์ด๊ฒŒ ๋” ์ผ๋ฐ˜์ ์ธ ์‚ฌ์šฉ์‚ฌ๋ก€์ผ ๊ฒƒ์ด๋‹ค.

๊ณต์‹ ์˜ˆ์ œ๋Š” ์—ฌ๊ธฐ์— ์žˆ๋‹ค.
https://github.com/anthropics/claude-cookbooks/tree/main/skills/custom_skills

๋จผ์ € ์Šคํ‚ฌ์„ ์ •์˜ํ•ด์•ผ ํ•œ๋‹ค.
๊ฐ•์š”๋˜๋Š” ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ๊ฐ€ ์žˆ๋‹ค.

๊ฐ€์žฅ ํ•„์ˆ˜์ ์ธ ๊ฒƒ์€ SKILL.md๋ผ๋Š” ํ•ต์‹ฌ ํ”„๋กฌํ”„ํŠธ ํŒŒ์ผ์ด๋‹ค.
์ €๊ธฐ ์ƒ๋‹จ์— ๋ฐ•ํ˜€์žˆ๋Š”๊ฒŒ ์ตœ์†Œํ•œ์˜ ์ •๋ณด๋ฅผ ๊ฐ€์ง„ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ์„น์…˜์ด๊ณ , ๊ทธ ์•„๋ž˜์— ์ƒ์„ธํ•œ ํ”„๋กฌํ”„ํŠธ๊ฐ€ ๋‚˜์—ด๋œ๋‹ค.


ํ•„์š”ํ•˜๋‹ค๋ฉด scripts ํด๋” ์•ˆ์— ์‚ฌ์šฉํ•  ํ•จ์ˆ˜๋ฅผ ๊ตฌํ˜„ํ•ด์„œ ๋„ฃ์–ด๋„ ๋œ๋‹ค.

๊ทธ๋ฆฌ๊ณ  skill์„ ์“ฐ๋ ค๋ฉด ์•คํŠธ๋กœํ”ฝ์— ์—…๋กœ๋“œ๋ฅผ ํ•˜๋Š” ๊ณผ์ •์ด ํ•„์š”ํ•˜๋‹ค.
ํ•ด๋‹น skill ๊ฒฝ๋กœ๋ฅผ ์••์ถ•ํ•œ ๋‹ค์Œ์— skill๋กœ ๋“ฑ๋กํ•˜๊ณ , ๊ทธ skill์˜ ID๋ฅผ ๊ฐ€์ ธ์™€์•ผ ํ•œ๋‹ค.

๊ทธ๋Ÿผ ์ด๋Ÿฐ ์‹์œผ๋กœ ID๊ฐ€ ๋ฐœ๊ธ‰๋œ๋‹ค.

์ € skill ID๋ฅผ ๋„ฃ๊ณ  ํ”„๋กฌํ”„ํŠธ๋ฅผ ์‹ฌ์–ด์„œ ๋™์ผํ•˜๊ฒŒ ๋ฉ”์„ธ์ง€๋ฅผ ์˜๋ฉด ๋œ๋‹ค.

๊ทธ๋ ‡๋‹ค.




๊ฐ์ƒ

๊ฐ€๋” ์œ ์šฉํ•œ ๊ฒฝ์šฐ๊ฐ€ ์žˆ์„ ๊ฒƒ ๊ฐ™๊ธด ํ•œ๋ฐ, ๊ธ€์Ž„... ์ง€๊ธˆ์œผ๋กœ์„œ๋Š” ์ข€ ๊ณ„๋ฅต ๊ฐ™์€ ๊ธฐ๋Šฅ ๊ฐ™๊ธฐ๋„ ํ•˜๋‹ค.
MCP, tools, ํ˜น์€ ์ผ๋ฐ˜์ ์ธ ๊ฐœ๋ฐœ ๋ฐฉ๋ฒ•์„ ๋‘๊ณ  ์™œ ์ด๊ฑธ ์จ์•ผํ•˜๋Š”์ง€์— ๋Œ€ํ•œ ๋‹น์œ„์„ฑ์ด ์ถฉ๋ถ„ํ•˜์ง€ ์•Š๋‹ค. ๊ฒŒ๋‹ค๊ฐ€ ์•คํŠธ๋กœํ”ฝ ํ™˜๊ฒฝ์— ์ง€๋‚˜์น˜๊ฒŒ ์ข…์†๋œ๋‹ค.

์ด๋Ÿฐ ์• ๋งคํ•œ ์ง€์ ๋“ค ๋•Œ๋ฌธ์ธ์ง€, ์‹ค์ œ๋กœ MCP์— ๋น„ํ•ด์„œ๋Š” ๊ด€์‹ฌ์„ ํฌ๊ฒŒ ๋ฐ›์ง€ ๋ชปํ•˜๋Š” ์ƒํ™ฉ์ด๋‹ค.



์ฐธ์กฐ
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/quickstart
https://github.com/anthropics/claude-cookbooks/tree/main/skills
https://simonwillison.net/2025/Oct/16/claude-skills/
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices