From 891312a90aa29b910f3445f081810d2fae035013 Mon Sep 17 00:00:00 2001 From: Mahesh Murag Date: Thu, 18 Dec 2025 12:02:02 -0500 Subject: [PATCH] Wording updates (#4) --- README.md | 18 +++++++++++++++++- docs/what-are-skills.mdx | 8 ++++---- 2 files changed, 21 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 565c261..b536f94 100644 --- a/README.md +++ b/README.md @@ -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. \ No newline at end of file diff --git a/docs/what-are-skills.mdx b/docs/what-are-skills.mdx index 6b52b60..1a5b1dd 100644 --- a/docs/what-are-skills.mdx +++ b/docs/what-are-skills.mdx @@ -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