SKILL.md
YAML frontmatter plus Markdown instructions. Name and description are required; license, compatibility, metadata, and allowed-tools are optional.
Guide · Agent asset supply chain
Skills are installable instructions, often with code attached, that run inside an agent. In practice, employees rarely install one skill in isolation. Skills arrive inside plugins, MCP servers, extensions, starter kits, and influencer-maintained repositories, often with little security review. This guide turns the OWASP Agentic Skills Top 10 public-review draft into checks security teams can run against that full bundle.
Reviewed against the OWASP Agentic Skills Top 10 public review v1 (OWASP Incubator Project, CC BY-SA 4.0) on September 18, 2026. The companion guide covers the OWASP Top 10 for Agentic AI.
Threat model · creation to consumption
Review the installed bundle, not only the named skill. Every handoff can add code, instructions, identity, and external access.
Agent Skills specification
YAML frontmatter plus Markdown instructions. Name and description are required; license, compatibility, metadata, and allowed-tools are optional.
Executable code, including shell, Python, or JavaScript, that the agent may run.
Documentation and supporting context loaded when the instructions reference it.
Templates, images, data, and other resources used to produce an output.
Discover: name + description
Activate: full SKILL.md
Use: supporting files on demand
The specification permits additional files and directories. Progressive disclosure reduces context use, but it also means security review cannot stop at the metadata initially visible to the agent.
01 · Authoring
The Agent Skills directory is combined with any plugin, MCP server, extension, dependency, hook, or repository configuration shipped beside it.



02 · Distribution
A marketplace, copied repository, extension, or influencer-maintained starter kit becomes the trusted source.

03 · Consumption
A user or workflow installs the bundle and approves its combined capabilities on a managed device.


Boundary 01 · Publisher to registry
Boundary 02 · Agent to enterprise
Boundary 03 · Enterprise to external
Commands, files, browsers, APIs, and connectors become execution paths.
Source code, cloud keys, tokens, memory, and business records are in reach.
Network requests, messages, deployments, and uploads cross the final boundary.
MCP defines one way an agent reaches tools. Skills supply instructions and may bring code, hooks, dependencies, and remote content. The boundary is rarely clean because community repositories commonly package several of these pieces together. Security review must follow the bundle from publisher to registry, endpoint, agent runtime, and external action.
AST01
Severity: Critical
Control family: Signed provenance and behavioral review
A skill can be malware from the day it is published. Antiy CERT linked 1,184 malicious skills to the ClawHavoc campaign. Snyk later confirmed 76 malicious payloads in a 3,984-skill corpus; 36.82% of that corpus had at least one security flaw.
What to check
AST02
Severity: Critical
Control family: Registry transparency and end-to-end provenance
The skill may be clean at authoring while its repository, publisher account, registry entry, dependency, or update path is compromised later. Check Point showed that repository-controlled Claude Code configuration could execute commands and expose an API key before the trust dialog in CVE-2025-59536.
What to check
AST03
Severity: High
Control family: Least-privilege capabilities and policy validation
A skill, plugin, or companion server can receive more file, shell, network, connector, or credential access than its task requires. Snyk documented more than 280 skills exposing API keys or personal data through excessive access. A later compromise inherits those grants.
What to check
AST04
Severity: High
Control family: Safe parsing, content review, and isolated loading
Instruction and manifest files such as SKILL.md, skill.json, manifest.json, and package.json are executable trust inputs. Unsafe parsers, deceptive metadata, hidden instructions, and brand impersonation can alter what an agent loads or what a user believes they approved.
What to check
AST05
Severity: High
Control family: Source inventory, content pinning, and continuous review
Skills can pull live instructions from URLs, documentation, issue threads, or other sources outside the publisher's control. Air Security reported 17,822 skills with at least one untrusted external instruction source in a 142,836-skill scan. Its proof-of-concept skill reached 26,000 agents after the scanners it tested cleared it.
What to check
Observed in the wild

What Would Elon Do?Cisco reported nine flaws, including silent data-exfiltration behavior
polymarket-trading-botThe earliest malicious package in Antiy CERT's campaign timeline
reddit-trendsOne package tied to the coordinated ClawHavoc registry poisoning
base-agentA separate ClawHavoc package distributed through the same publisher network
polymarket-all-in-oneContained code capable of downloading a remote-control trojan
Each example links to the supporting Cisco AI Defense or Antiy CERT research. No executable instructions are reproduced.
Ecosystem shown: Cursor · OpenClaw · VS Code · Claude
AST06
Severity: High
Control family: Process, filesystem, credential, and network isolation
A skill without process, filesystem, credential, and network boundaries can act with the host user's authority. Microsoft Defender recommends treating self-hosted agent runtimes such as OpenClaw as untrusted code execution with persistent credentials and running them in a dedicated isolated environment.
What to check
AST07
Severity: Medium
Control family: Immutable pinning, change detection, and reapproval
Approval applies to reviewed content, not a permanent skill name. Branch references, silent publisher changes, transitive dependencies, and bundled repository updates can make the installed artifact differ from the approved one.
What to check
AST08
Severity: Medium
Control family: Layered static, semantic, and behavioral review
A clean scanner result is not an approval. Skill risk may sit in natural-language instructions, remote content, bundled scripts, conditional behavior, or interactions between packages. Trail of Bits reported bypassing the public skill scanners it tested in under an hour.
What to check
AST09
Severity: Medium
Control family: Unified inventory, ownership, policy, and revocation
Security teams cannot govern packages they cannot find or assign. Skills often arrive through a larger plugin, extension, MCP server, or community repository, so a skill-only inventory misses the deployment unit, its owner, and the path needed to revoke it.
What to check
AST10
Severity: Medium
Control family: Portable identity, provenance, and policy metadata
The same capability can be copied between marketplaces, repositories, plugins, and agent products under different names and package formats. Each port can drop provenance, permissions, ownership, or prior findings, leaving separate teams to review the same underlying behavior again.
What to check
Apply this gate to the whole installed bundle: skill, plugin, extension, MCP server, repository files, dependencies, and remote sources.
For these risks in real incidents, read the Civilizations threat briefings.
Optimus discovers every skill, MCP server, and agent across your endpoints, scores what each one can do, and watches what it does at runtime.
Backed by