diff --git a/docs/home.mdx b/docs/home.mdx index 06ee8dd..51b64c1 100644 --- a/docs/home.mdx +++ b/docs/home.mdx @@ -10,20 +10,11 @@ Agent Skills are folders of instructions, scripts, and resources that agents can ## Why Agent Skills? -Agents are increasingly capable, but often don't have the context they need to do real work reliably. Skills solve this by giving agents access to procedural knowledge and company-, team-, and user-specific context they can load on demand. Agents with access to a set of skills can extend their capabilities based on the task they're working on. +Agents are increasingly capable, but often don't have the context they need to do real work reliably. Skills solve this by packaging procedural knowledge and company-, team-, and user-specific context into portable, version-controlled folders that agents load on demand. This gives agents: -**For skill authors**: Build capabilities once and deploy them across multiple agent products. - -**For compatible agents**: Support for skills lets end users give agents new capabilities out of the box. - -**For teams and enterprises**: Capture organizational knowledge in portable, version-controlled packages. - -## What can Agent Skills enable? - -- **Domain expertise**: Package specialized knowledge into reusable instructions, from legal review processes to data analysis pipelines. -- **New capabilities**: Give agents new capabilities (e.g. creating presentations, building MCP servers, analyzing datasets). -- **Repeatable workflows**: Turn multi-step tasks into consistent and auditable workflows. -- **Interoperability**: Reuse the same skill across different skills-compatible agent products. +- **Domain expertise**: Capture specialized knowledge — from legal review processes to data analysis pipelines to presentation formatting — as reusable instructions and resources. +- **Repeatable workflows**: Turn multi-step tasks into consistent, auditable procedures. +- **Cross-product reuse**: Build a skill once and use it across any skills-compatible agent. ## Adoption