3 Principles for Designing Agent Skills | Block Engineering Blog

March 10, 2026

Wooden desk with cards featuring icons like tools, globe, and lightbulb, a coffee cup, succulent, yellow rubber duck, and ...

Skills are an open standard supported by most major AI coding tools: Claude Code, Goose, Cursor, Amp, GitHub Copilot, Gemini CLI, VS Code, and many more.

At their simplest, a skill is a folder with a SKILL.md file with a set of instructions that an agent can discover and load on demand. Think of it like a playbook. When an agent encounters a task that matches a skill’s description, it loads those instructions and follows them. Skills can also include supporting files like scripts, templates, MCP servers, and configuration files.

The beauty is in the portability. Write a skill once, and it works for anyone across any agent that supports the format.

Source

Here’s a good introduction to agent skills from the open source team at Block.