1

1. What this skill is

2

Agent Skills is an open folder format for giving compatible agents reusable instructions and resources. A minimal skill contains SKILL.md with a name, description, and task instructions.

3

2. What it can help with

4

The specification explains discovery, activation, and execution. Optional scripts, references, and assets let a skill carry deterministic tools without loading everything into context at startup.

5

3. Recommended first use

6

Read the overview, compare the documented folder tree with one official example, then write a tiny instruction-only skill before adding scripts or external dependencies.

7

4. Requirements

8

You need an Agent Skills-compatible client. The repository is a specification and documentation source, not a one-click skill marketplace.

9

5. Who it suits

10

Useful for beginners who want to evaluate skill repositories or create a portable internal workflow.

11

6. Limits and safety

12

Compatibility does not mean every client supports the same hooks, permissions, or installation path. Individual skills can use different licenses. Treat scripts and binaries as code, verify referenced URLs, keep secrets outside skill files, and require explicit approval for destructive or external actions.

13

7. Project and license

14

Repository content is provided under Apache-2.0 code and CC-BY-4.0 documentation; check the current LICENSE before reuse. Repository: https://github.com/agentskills/agentskills

15

Break the goal into input, action, and output before adding review checkpoints.

16

Keep examples, failure conditions, and review criteria so the tutorial stays reusable.

Tip: test with a small example before using the workflow on real work.