Ano ang agent skill (SKILL.md) at paano suriin ang isa

Ang skill ay isang folder na may SKILL.md file na nasa lugar kung saan hinahanap ito ng iyong coding agent. Binabasa ng agent ang file lamang kapag tumutugma ang iyong request dito. Hanggang doon, ang skill ay nagkakahalaga ng mga isandaang token, samantalang ang prompt ay sumasama sa bawat mensaheng pinapaste mo ito.

Malamang na nakita mo na ang salitang ito sa isang README: "i-install ang skill, pagkatapos hilingin sa agent na...". Walang misteryoso dito. Sa ibaba: ano ang nasa loob, kailan ito pumapasok sa context window, at paano tingnan ang isa bago mo ito payagan sa iyong makina.

Ano ang skill, at paano ito naiiba sa prompt#

Inilalarawan ng Agent Skills documentation ng Anthropic (sinuri noong 30 Oktubre 2026) ang skill bilang isang reusable, filesystem-based na resource: isang directory na may SKILL.md file, kasama ang opsyonal na mga script, template at reference file. Ang SKILL.md ay nagsisimula sa maliit na YAML header (isang pangalan at isang paglalarawan) at nagpapatuloy sa simpleng mga instruksyon.

Isipin mo ang isang bagong katrabaho. Ang prompt ay ikaw na nakatayo sa likod ng kanilang upuan at inuulit ang mga patakaran tuwing umaga. Ang skill ay isang binder sa shelf na may label sa gilid: "Estilo ng commit message. Basahin ito kapag may nagpapa-commit sa iyo." Binababa nila ito kapag kailangan lang.

Dalawang header field ang kailangan, at may mga patakaran ang format. Sa Skills format ng Claude, ang name ay hindi hihigit sa 64 na character: maliliit na letra, digit at hyphen, at hindi ito maaaring maglaman ng mga salitang "anthropic" o "claude". Ang description ay hindi maaaring walang laman, may limitasyong 1,024 na character, at dapat sabihin pareho kung ano ang ginagawa ng skill at kailan ito gagamitin.

Paano pumapasok ang skill sa context window#

Tinatawag ito ng documentation na progressive disclosure: binabasa ng agent ang isang skill sa tatlong yugto, at bawat yugto ay binabayaran lamang kung naabot ito.

• Level 1, laging naka-load. Ang pangalan at paglalarawan ng bawat naka-install na skill, mga 100 token bawat skill.
• Level 2, kapag na-trigger. Ang katawan ng SKILL.md, wala pang 5,000 token.
• Level 3, kapag kailangan lang. Mga bundled file at script. Kapag pinapatakbo ng agent ang isang script, hindi pumapasok sa context ang code ng script, ang output lang nito.

Ang mga token figure ay approximations ng documentation, hindi eksaktong bilang.

Narito kung bakit mahalaga ito sa iyong bill. Sabihin nating may 20 skill kang naka-install. 20 × 100 = 2,000 token ang sumasama mula sa unang mensahe. Muling ipinapadala ng agent ang context nito sa bawat hakbang (ipinapakita ng 20-step na halimbawa kung bakit), kaya ang 50-step na session ay may 50 × 2,000 = 100,000 input token ng skill labels. Sa DeepSeek-V4-Flash iyon ay $0.0015 sa kasalukuyang presyo.

Ngayon sa kabilang paraan. Kung ang dalawampung skill na iyon ay pinaste bilang isang malaking prompt, ang bawat katawan ay nasa bawat request: hanggang 20 × 5,000 = 100,000 token bawat request, hindi bawat session. Ang agwat na iyon ang buong punto ng pag-load on demand. Kung malabo pa ang terminong "context window", saklaw ng explainer na ito kung ano ang pumupuno dito.

Nasa context ang mga skill, kaya kailangan ng modelong nasa likod ng agent ng espasyo para sa mga ito. Ang DeepSeek-V4-Flash sa CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) ay may 380K context window at hanggang 32,768 output token bawat sagot, isang presyo sa anumang oras ng araw, at OpenAI- at Anthropic-compatible na API. Para sa terminal agent, sundan ang paano ikonekta ang Claude Code sa CheapTokens; para sa anumang ibang tool, magsimula sa mga docs. Ang sariling pahina ng modelo ay dito.

Sumulat ng minimal na skill sa dalawang minuto#

Mas madaling magbasa pagkatapos magsulat ng isa. Ang skill na ito ay pinapasulat sa agent ng commit messages sa isang fixed na format. Sa Claude Code, ang mga personal na skill ay nasa ~/.claude/skills/ at ang mga project skill ay nasa .claude/skills/, kaya ang isang project skill ay maaaring sumama sa repository.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

I-paste ito sa file:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Ngayon buksan ang agent sa isang repository na may staged changes at tanungin: "write a commit message for what I staged". Nakikita ng agent ang paglalarawan, nagpapasya na tumutugma ito, binabasa ang apat na patakaran at sinusunod ang mga ito. Kung binabalewala nito ang skill, tingnan muna ang description: dapat nitong pangalanan ang sitwasyon, dito "commit", sa mga salitang aktwal mong gagamitin.

Isang catch: hindi nag-sync ang mga skill sa pagitan ng claude.ai, ng API at ng Claude Code. Ang skill na ginawa mo sa isang lugar ay kailangang idagdag nang hiwalay sa iba.

Skill, AGENTS.md, MCP: alin ang alin#

Palaging napagkakamalan ang tatlong ito. Ang rules file tulad ng AGENTS.md o CLAUDE.md ay binabasa sa simula ng session at naglalaman ng mga katotohanan tungkol sa project (paano masisira ang file na iyon sa isang Downloads folder). Ang MCP server ay nagbibigay sa agent ng mga bagong tool at data na maaabot (MCP sa simpleng Ingles). Ang skill ay isang pamamaraan: paano gawin ang isang uri ng trabaho, nilo-load kapag lumitaw ang trabahong iyon.

Suriin ang third-party na skill bago mag-install#

Ang skill ay text na sinusunod ng agent, at kung minsan ay code na pinapatakbo ng agent. Sinasabi ng documentation na gumamit lamang ng mga skill mula sa mapagkakatiwalaang pinagmulan, i-audit ang bawat bundled file (SKILL.md, script, resources), at hanapin ang mga hindi inaasahang network call o file access. Ang mga skill na kumukuha ng external URL ay mas risky. Sa Claude Code, ang isang skill ay may parehong network access tulad ng anumang program sa iyong computer, kaya ituring ang pag-install na parang pag-install ng software.

Isang magandang specimen ang universal-modder, isang game-modding toolkit. Inilalarawan ng README nito (sinuri noong 30 Oktubre 2026) ang isang MIT-licensed na set ng mga skill sa Agent Skills format, isang Python CLI na tinatawag na um, isang MCP server para sa asset generation sa pamamagitan ng fal, at isang shared knowledge base ng field notes. Ang pangunahing skill, mod-any-game, ay sumasaklaw sa recon, reverse engineering, asset generation, in-game testing at packaging. Inililista ng README ang Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot at OpenCode bilang mga sinusuportahang tool, at sinasabi nitong tumatanggi ang toolkit na i-bypass ang anti-cheat o DRM. Sa Claude Code, nag-i-install ito gamit ang /plugin marketplace add rehan-remade/universal-modder, at ang asset generation ay nangangailangan ng hiwalay na fal API key.

Pansinin kung ano ang nilalaman ng listahang iyon: mga skill, isang command-line program at isang server. Ang pagbasa ng isang SKILL.md ay sasaklaw lamang sa isang bahagi ng iyong ini-install. Kaya daanan ang mga piraso:

Ang pangunahing patakaran ay nasa paano mag-imbak ng API key nang ligtas. Walang petsa ng huling commit sa page ng repository, kaya tingnan kung gaano kamakailan na-update ang project bago ka umasa dito.