Wording updates (#4)

This commit is contained in:
Mahesh Murag
2025-12-18 12:02:02 -05:00
committed by GitHub
Unverified
parent f990ba148d
commit 891312a90a
2 changed files with 21 additions and 5 deletions
+17 -1
View File
@@ -1 +1,17 @@
# agentskills
# Agent Skills
[Agent Skills](https://agentskills.io) are a simple, open format for giving agents new capabilities and expertise.
Skills are folders of instructions, scripts, and resources that agents can discover and use to perform better at specific tasks. Write once, use everywhere.
## Getting Started
- [Documentation](https://agentskills.io) - Guides and tutorials
- [Specification](https://agentskills.io/specification) - Format details
- [Example Skills](https://github.com/anthropics/skills) - See what's possible
This repo contains the specification, documentation, and reference SDK. Also see a list of example skills [here](https://github.com/anthropics/skills).
## About
Agent Skills is an open format maintained by [Anthropic](https://anthropic.com) and open to contributions from the community.
+4 -4
View File
@@ -47,7 +47,7 @@ Use this skill when the user needs to work with PDF files...
...
```
The frontmatter is required:
The following frontmatter is required at the top of `SKILL.md`:
- `name`: A short identifier
- `description`: When to use this skill
@@ -56,11 +56,11 @@ The Markdown body contains the actual instructions and has no specific restricti
This simple format has some key advantages:
**Version-controlled**: Skills are files and therefore work naturally with Git.
- **Self-documenting**: A skill author or user can read a `SKILL.md` and understand what it does, making skills easy to audit and improve.
**Self-documenting**: A skill author or user can read a `SKILL.md` and understand what it does, making skills easy to audit and improve.
- **Extensible**: Skills can range in complexity from just text instructions to executable code, assets, and templates.
**Extensible**: Skills can range in complexity, since they can contain text instructions, scripts, assets, templates, or reference docs.
- **Portable**: Skills are just files, so they're easy to edit, version, and share.
## Next steps