Agent skills: What are they and how do they work?

Last updated: 8/19/2026

As AI agents become an increasingly important part of an organization's infrastructure, engineering teams are shifting away from massive, monolithic system prompts. Instead, they are adopting agent skills as a more lightweight, modular approach. This pattern moves AI development toward reproducible, version-controlled workflows. By using skills, developers can equip agents with specialized expertise that is easier to audit, safer to deploy, and more cost-effective to scale in production environments.

Skills vs MCP: How AI tools have evolved

What are agent skills?

Agent skills are reusable packages of instructions and context, written in natural language, that extend an AI agent's capabilities, providing specialized expertise for specific tasks. They are designed to help agents complete complex workflows that the base large language model (LLM) might not reliably handle on its own. 

Agent skills and progressive disclosure

Traditional LLM prompting often forces the model to load all potential instructions upfront, which can waste the context window and degrade performance, as the model struggles to prioritize relevant information. Agent skills use "progressive disclosure", which is a design pattern where the agent only accesses the specific capabilities required for the task it is currently performing.

For example, if an agent is tasked with a data cleaning job, it doesn't need to load security audit instructions. The agent starts with a minimal base prompt and only "discloses" and loads the specific "Data Cleaner" skill into its context when the user asks for a database query.

The core structure of an agent skill

A skill is essentially a self-contained directory or folder that includes the instructions and assets needed to perform a specific task, written in simple language so no coding experience is needed. It relies on a mix of required metadata and optional bundled assets to function, ensuring that the agent has everything it needs to perform a task without unnecessary overhead. 

Required: The SKILL.md file and YAML frontmatter

This is the mandatory core component of a skill, and contains the instructions the agent follows. 

  • YAML Frontmatter: Placed at the top of the file, this contains the name and description (maximum 1024 characters). The agent reads only this part at startup to see which skills are available. This metadata powers progressive disclosure.
  • Markdown Body: This contains the actual procedural instructions, step-by-step guidance, and examples the agent follows once the skill is activated.

Optional: Bundled resources like scripts and reference materials

You can add subdirectories to make skills more powerful. A scripts/ folder can hold executable code (like Python or bash), while references/ or assets/ can store templates, API docs, or schemas. The agent can run these scripts to get deterministic outputs without the code itself taking up space in the context window.

How do agents load and execute skills?

To maintain performance, agents must balance being feature-rich with staying responsive. The agent uses a tiered approach to access only the relevant instructions for the task at hand instead of loading the entire library of capabilities at once. This process ensures the agent remains both lightweight and specialized throughout the session.

  1. Discovery: At startup, the agent loads only the metadata (~100 tokens per skill) into the system prompt to know what is available.
  2. Activation: When a task matches a skill's description, the agent uses bash commands to read the full SKILL.md instructions into its active context.
  3. Execution: The agent follows the workflow, selectively reading referenced files or executing bundled scripts only as the task requires.

Frequently asked questions

Find answers to some frequently asked questions about agent skills.

Agent skills provide the procedural memory, which are essentially the instructions and local scripts, to complete a task. MCP provides a standardized protocol to connect agents to live external data sources. They are complementary; an agent skill often contains the instructions on how to query an MCP server.

Fine-tuning bakes knowledge into the weights of an LLM, which is expensive and difficult to update. Agent skills act as external, swappable procedural memory that the agent reads dynamically, making them easier to edit and secure.

The SKILL.md file is the core component of any Agent skill. It contains YAML frontmatter for agent discovery, followed by markdown-formatted instructions that dictate the workflow the agent must follow.

Skills  are version controlled which can introduce risks like supply chain attacks or indirect prompt injections. Agent Platform mitigates these by executing all scripts in strictly isolated, sandboxed environments governed by IAM policies.

Developers can add security capabilities by installing pre-built skills for tasks like secret detection or dependency auditing. These skills provide deterministic workflows and local static-analysis scripts (such as Semgrep) to scan for vulnerabilities in real time.

Key differences: agent skills versus traditional system prompts

The move to agent skills is a shift from writing broad prose to enforcing more granular, specific prompts. 

  • Process over prose: Skills enforce deterministic checkpoints and exit criteria rather than relying on generic best-practice essays.
  • Token efficiency: Skills only consume the context window when triggered, allowing you to install dozens of skills with minimal overhead.
  • Cross-platform interoperability: Based on an open specification, these skills work across tools like Antigravity CLI, Gemini Enterprise Agent Platform, Claude Code, VS Code, Cursor, and other custom CLI tools.
  • Composability: Agents can combine multiple skills dynamically to complete complex, multi-step workflows.

Feature

Traditional System Prompts

Agent Skills

Primary Focus

General behavior and style guidelines.

Deterministic workflows and executable logic.

Context Usage

Loads all instructions into every turn.

Progressive disclosure (loads only when triggered).

Execution

Relies on LLM reasoning and internal memory.

Offloads work to scripts (Python/bash) and templates.

Maintenance

Requires editing a monolithic system prompt.

Version-controlled, modular filesystem directories.

Reliability

Can be prone to hallucinations in complex tasks.

Higher determinism through explicit exit criteria.

Portability


Often proprietary to the agent framework.

Open specification (interoperable across tools).

Feature

Traditional System Prompts

Agent Skills

Primary Focus

General behavior and style guidelines.

Deterministic workflows and executable logic.

Context Usage

Loads all instructions into every turn.

Progressive disclosure (loads only when triggered).

Execution

Relies on LLM reasoning and internal memory.

Offloads work to scripts (Python/bash) and templates.

Maintenance

Requires editing a monolithic system prompt.

Version-controlled, modular filesystem directories.

Reliability

Can be prone to hallucinations in complex tasks.

Higher determinism through explicit exit criteria.

Portability


Often proprietary to the agent framework.

Open specification (interoperable across tools).

What are the benefits of agent skills?

Adopting agent skills changes the economics and safety of your AI deployment. By moving instructions out of chat boxes and into version-controlled repositories, you gain predictability and better governance.

Lower LLM API costs

Progressive disclosure ensures the AI doesn't load massive, multi-page system prompts on every turn, reducing input token consumption.

Enterprise-grade governance

Because skills are standard filesystem directories, you can manage them via Git. This allows for standard pull request (PR) reviews, security scans, and rollbacks.

Reduced hallucinations

By relying on executable scripts for tasks like math or API calls, skills offload work to deterministic code, which can help reduce the chance of an LLM guessing incorrectly.

Cross-team reusability

A well-documented skill, such as a corporate compliance checker, can be built once and deployed across hundreds of agents throughout your company.

Granular observability

Each skill activation is logged as a discrete event. This helps makes it easer to trace exactly which capability was used, helping teams debug agent failures and optimize performance.

Accelerated developer velocity

Standardizing on an open skill format lets engineers more easily share and reuse verified capabilities. Instead of writing custom prompts for every agent, teams can pull from an internal catalog of approved skills to build new AI workflows faster.

Real-world use cases for agent skills

Agent skills help move AI from a general assistant to a production-ready digital worker.

Automated code review and standardization

Engineering teams use agent skills to enforce coding standards. For example, a skill can include a company style guide in its references/ folder and a linting script in scripts/. When a developer submits a PR, the agent runs the script to check for errors and leaves review comments based on the style guide, without needing someone to write a complex prompt.

Enterprise document processing

Agents use parsing skills to extract structured data from PDFs, spreadsheets, or text. The agent loads the heavy parsing scripts only when a document is actively being processed, saving massive amounts of context window space.

Data analysis and schema navigation

Data analysts use skills to interact with databases safely. An agent loads a "Data Analyst" skill containing the database schema. This provides the context needed to write accurate SQL queries, which it executes using a bundled data-connector script.

Security auditing

DevOps teams can create a skill that bundles infrastructure-as-code (IaC) security policies. Before a cloud environment is provisioned, the agent uses the skill to run validation scripts against configuration files, ensuring no open ports or unencrypted buckets are deployed.

Brand compliance

Enterprise knowledge workers can create skills to ensure all user-facing copy aligns with brand voice guidelines.

Security, governance, and verifiable trust

Because agent skills can be packaged with executable privileges, they can expand your attack surface. You must treat them with the same security rigor as any other software dependency.

Enterprise platforms can help mitigate this risk by scanning skills for vulnerabilities, like hidden instructions or excessive agency, before deployment. Cryptographic signing allows developers to attach a digital signature to the skill directory, proving authenticity and ensuring it hasn't been tampered with.

Deploying agent skills within the Google Cloud AI ecosystem

Agent skills integrate natively into the Google Cloud AI ecosystem. Gemini Enterprise Agent Platform lets you manage autonomous agents with a single API call, allowing you to upload custom skills or use pre-built ones for complex enterprise workflows.

These agents are powered by the Antigravity harness, which provides a secure, sandboxed environment for reasoning, planning, and execution. These skills work with the Model Context Protocol (MCP) to safely connect agents to live external data sources, ensuring your setup is both secure and auditable.

Building agent skills with Google Cloud's Agent Development Kit (ADK)

Agent Development Kit (ADK) is the primary framework for using the open agent skills standard with enterprise infrastructure. You can use the ADK to deploy skills to Gemini-powered agents, allowing them to execute bundled Python or bash scripts within isolated, sandboxed compute environments.

The ADK allows skills to authenticate with services like BigQuery and Cloud Storage, while ensuring every skill activation and script execution is captured in Cloud Logging and Cloud Monitoring for full auditability.

For a starting point, visit the official Google Agent Skills repository. It provides "agent-first" skill packs for products like BigQuery, Cloud Run, and GKE. You can install these verified capabilities using standard commands like npx skills add google/skills.

Take the next step

Start building on Google Cloud with $300 in free credits and 20+ always free products.

Google Cloud