agent/agentskills
2
0
Fork 0
mirror of https://github.com/agentskills/agentskills.git synced 2026-06-18 15:54:06 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge "Why" and "What" sections on home.mdx landing page

Browse Source 
The "Why Agent Skills?" audience bullets and the "What can Agent Skills
enable?" capability bullets were two angles on the same material, with
direct duplicates between them (e.g. "For skill authors" vs.
"Interoperability", "For compatible agents" vs. "New capabilities").

Collapse both into a single "Why Agent Skills?" section: keep the
problem statement, fold "portable, version-controlled" into the opener,
drop the circular "new capabilities" bullet (absorbing its examples into
"Domain expertise"), and rename "Interoperability" to "Cross-product
reuse". The new "This gives agents:" transition leads into three
non-overlapping bullets.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jonathan Hefner
2026-04-19 11:32:42 -05:00
Unverified
parent 8d8fcbc69e
commit 2a439b80e5
1 changed files with 4 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/home.mdx
+4 -13
View File
@@ -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