Agent Skills Guide

How Agent Skills work.

An Agent Skill is a folder of instructions and supporting files. Claude Code, Codex, and other compatible agents load it when the request matches its description.

Review checklist

Check the package before installing.

SKILL.md normally contains a name, a trigger description, and the working instructions.

References, scripts, templates, and examples belong beside it when they make the workflow more reliable.

A public GitHub URL makes a skill inspectable. It does not automatically make the code safe or permissively licensed.

Examples

Three packages to read

01 166.9K repo stars
skill-creator

anthropics/skills

Create, improve, evaluate, and benchmark reusable Agent Skills with a structured workflow.

Content language
English
Repository license
Apache-2.0

Source updated

02 268.6K repo stars
brainstorming

obra/superpowers

A disciplined discovery workflow for exploring intent, constraints, requirements, and design before implementation.

Content language
English
Repository license
MIT

Source updated

03 70K repo stars
browser-use

browser-use/browser-use

Control a browser for automation, scraping, testing, screenshots, and repeatable web workflows.

Content language
English
Repository license
MIT

Source updated

Read SKILL.md

Check the trigger, workflow, required tools, and expected outputs.

Inspect scripts

Look for network access, filesystem changes, credentials, and destructive commands.

Install narrowly

Choose project or personal scope intentionally and avoid overlapping skills.