---
stable_id: skills/agentskills-skill
type: skills
title: agentskills-skill
summary: >-
  ---

  name: Agent

  description: Use when creating, optimizing, or evaluating Agent Skills — the
  open format for extending AI agent capabilities. Reach for this skill when
  building SKILL.md files, testing skill descriptions, bundling scripts, or
  implementing skills support in an agent client.

  metadata:
      mintlify-proj: agent
      version: "1.0"
  ---

  # Agent Skills

  ## Product summary

  Agent Skills is an open format for packaging specialized knowledge and
  workflows into portable, version-controlled folders that AI agents load on
  demand. A skill is a directory containing a `SKILL.md` file (metadata +
  instructions) plus optional scripts, references, and assets. Agents discover
  skills at startup, load only the name and description initially, and pull full
  instructions when a task matches the skill's scope. This progressive
  disclosure keeps context efficient while giving agents access to domain
  expertise, repeatable workflows, and cross-product reuse.
tags: []
source_url: https://agentskills.io/skill.md
license: ""
upstream_ref: ""
github_stars: null
github_forks: null
github_is_organization: null
retrieved_at: 2026-06-11T08:31:51.181Z
content_sha256: 415bae7d5099fe082b159ba6651607456a37c2f9a99e82f730033846f27cff48
---
