agentskills

Add "Optimizing descriptions" guide for skill creators

How-to guide covering the full description optimization workflow:
writing effective descriptions, designing trigger eval queries
(should-trigger and should-not-trigger with near-miss examples), testing
trigger rates with a bash eval script, train/validation splits to avoid
overfitting, and the iterative optimization loop.

The guide is client-agnostic by default but includes a working Claude
Code example in the `check_triggered` function using
`--output-format json` and `jq` to detect `Skill` tool calls.

Adds the page to the "For skill creators" navigation group in
`docs.json`.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Jonathan Hefner · 2026-03-05 11:28:23 -06:00

e9dff6b3d2

Merge pull request #203 from jonathanhefner/add-evaluating-skills-guide

Add "Evaluating skills" guide for skill creators

Jonathan Hefner · 2026-03-05 11:24:53 -06:00

09055204dd

Add comprehensive "Integrating skills" guide for client implementors (#200 )

* Add comprehensive "Integrating skills" guide for client implementors

Replace the existing `integrate-skills.mdx` page with a thorough,
research-backed guide at `client-implementation/integrating-skills.mdx`.

The guide covers the full Agent Skills integration lifecycle in five
steps: discover, parse, disclose, activate, and manage context. It was
developed from analysis of seven real-world implementations (OpenCode,
Pi, Gemini CLI, Codex, VS Code Copilot Chat, Goose, OpenHands) and
addresses the practical design decisions developers face: progressive
disclosure architecture, cross-client `.agents/skills/`
interoperability, lenient YAML parsing for compatibility, catalog XML
format, behavioral instruction templates (derived from Pi's production
prompts), file-read vs. dedicated tool activation, structured wrapping
for context compaction, and permission allowlisting for bundled
resources.

The guide is architecture-neutral — it covers local filesystem agents,
cloud-hosted/sandboxed agents, and agents with or without file-read
capabilities, framing these as independent design choices rather than
rigid categories.

Also adds a redirect from the old `/integrate-skills` URL and updates
all internal links (`docs.json`, `home.mdx`, `what-are-skills.mdx`).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Address PR review feedback on integrating skills guide

- Clarify that the XML catalog format is just one option — JSON or
  bulleted lists work equally well
- Qualify "works with any model" to note it requires a file-reading tool

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Rename "Integrating skills" guide to "Adding skills support"

Addresses reviewer feedback that "Integrating" could be misread as
integrating skills into a workflow rather than into a client. Renames
`integrating-skills.mdx` to `adding-skills-support.mdx` and updates all
references in `docs.json`, `home.mdx`, and `what-are-skills.mdx`.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Jonathan Hefner · 2026-03-05 11:24:08 -06:00

07278fe14a

Add "Evaluating skills" guide for skill creators

A how-to guide for evaluating skill output quality using structured
evals. Covers the full eval workflow: designing test cases, running
with-skill vs. baseline comparisons, writing assertions, LLM-based
grading, aggregating benchmarks, analyzing patterns, human review, and
LLM-driven iterative improvement.

Derived from the workflow implemented by the `skill-creator` Skill, but
written as a standalone guide that readers can follow without using that
tool.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Jonathan Hefner · 2026-03-04 09:37:49 -06:00

863f7c2857

Add Snowflake logo to Agent Skills logo carousel (#199 )

.... Generated with [Cortex Code](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code)

Co-authored-by: Cortex Code <noreply@snowflake.com>

Umesh Unnikrishnan · 2026-03-02 05:02:58 -08:00

f019a02dbb

Add package.json to docs for local mint dev dependency (#141 )

* Add package.json to docs for local mint dev dependency

Allow installing mint as a local dev dependency instead of requiring
a global install, making the setup more reproducible.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Use npx mint dev to avoid mint version bug

Address PR review feedback: the mint package has a bug that causes it
to use the wrong version when installed as an npm dependency. Switch to
npx mint dev, remove the devDependency and package-lock.json, and
simplify docs accordingly.

* Move `package.json` to repo root and clean up docs

Move the `package.json` from `docs/` to the repo root so `npm run dev`
works from anywhere in the repository. Update `CLAUDE.md` instructions
to match, trim boilerplate from `docs/README.md`, and link to the live
documentation site.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

lilac · 2026-02-27 17:47:34 -06:00

fbb6c829fd

Add "Using scripts" guide for skill creators (#196 )

* Add "Using scripts" guide for skill creators

New guide at `docs/skill-creation/using-scripts.mdx` covering how to use
commands and scripts in skills:

- One-off commands with `uvx`, `pipx`, `npx`, `bunx`, `go run`,
  `deno run` (tabbed by ecosystem, with pinned version examples)
- Referencing bundled scripts from `SKILL.md` using relative paths
- Self-contained scripts with inline dependency declarations (PEP 723,
  Deno `npm:` imports, Bun auto-install, Ruby `bundler/inline` — tabbed
  with a common HTML-parsing example)
- Designing scripts for agentic use: non-interactive execution, `--help`
  documentation, error messages, structured output, and a compressed
  checklist of further considerations

Also updates `docs/docs.json` to organize navigation into groups ("For
skill creators" and "For client implementors").

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Address review feedback on "Using scripts" guide

Relative paths note: Clarify that the convention applies to support
files like `references/*.md`, and explain *why* (the agent runs commands
from the skill root).

Structured output: Reframe motivation around composability with both
agents and standard tools (`jq`, `cut`, `awk`) rather than LLM parsing
ambiguity. Shorten prose; let the code example's inline comments carry
the contrast.

Predictable output size: Add `--output` flag as an alternative strategy
for scripts whose output is large and not amenable to pagination. The
`--output` flag acts as a consent mechanism — the agent must explicitly
choose a file destination or pass `-` to opt in to stdout, preventing
accidental context-window flooding.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Jonathan Hefner · 2026-02-27 15:52:36 -06:00

6102affec8

Add Laravel Boost logo to Agent Skills logo carousel (#167 )

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

Pushpak Chhajed · 2026-02-22 13:41:31 -06:00

201eb2faf3

Add Emdash logo to LogoCarousel (#132 )

Arne Strickmann · 2026-02-22 13:39:43 -06:00

0e96f39bf8

Add openhands logo (#118 )

* Add OpenHands logo to adoption carousel

OpenHands is an AI software development platform that natively supports
Agent Skills, enabling users to extend agent capabilities with specialized
knowledge and workflows.

Changes:
- Added openhands-logo-light.svg and openhands-logo-dark.svg to /docs/images/logos/openhands/
- Added OpenHands entry to LogoCarousel.jsx

Website: https://www.all-hands.dev/

* Update OpenHands logos to full color versions

---------

Co-authored-by: jamiechicago312 <jamiechicago312@users.noreply.github.com>
Co-authored-by: openhands <openhands@all-hands.dev>

Jamie Chicago · 2026-02-22 13:38:13 -06:00

f682292a31

Add Junie logo to the logos carousel (#116 )

Irina Chichikova · 2026-02-22 13:36:47 -06:00

b8241441e0

Fix logo carousel snap at animation loop boundary (#165 )

The `logo-scroll` keyframe translated by `-50%`, but flex `gap: 3rem`
means `2N` duplicated items have `2N - 1` gaps — so the track doesn't
split evenly at 50%. The seam between the two copies sits at
`50% + half a gap`. Adjusting to `calc(-50% - 1.5rem)` aligns the
animation endpoint with the start of the second copy, eliminating the
visible jump every 50 seconds.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Jonathan Hefner · 2026-02-15 16:21:18 -06:00

b7442eb9ac

Remove MCP-specific CSS from style.css (#113 )

This file was originally copied from the modelcontextprotocol repo.
These styles were specific to MCP documentation pages and are not used
here:

- `#feature-support-matrix-wrapper` table styling
- `#schema-reference` TypeScript documentation styling

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Jonathan Hefner · 2026-02-15 13:43:31 -06:00

fe4fecbb43

Add Qodo logo to Agent Skills (#123 )

Nnenna Ndukwe · 2026-02-06 07:52:42 -08:00

e81550daf1

Fix VT Code logo sizing, centering, and file references in carousel

Eric Harmeling · 2026-01-27 13:46:41 -05:00

c9e5df0a28

Add VT Code logo to LogoCarousel (#104 )

Vinh Nguyen · 2026-01-27 13:46:31 -05:00

3c6ce2f163

Add Ona logo to adoption carousel

Co-Authored-By: Claude <noreply@anthropic.com>

Eric Harmeling · 2026-01-23 10:40:04 -05:00

2d0014513b

Adjust logo widths in adoption carousel for consistent sizing

Co-Authored-By: Claude <noreply@anthropic.com>

Eric Harmeling · 2026-01-23 10:36:42 -05:00

19d5c9fead

adding Autohand Code on the agentskills.md (#101 )

Igor Costa · 2026-01-23 10:29:40 -05:00

f8dfba0740

Adds Roo Code Logo (#99 )

Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>

Bruno Bergher · 2026-01-23 10:28:13 -05:00

4966c3fcbd

Include Mistral Vibe (#44 )

* Create todo.md

* Add files via upload

* Delete docs/images/logos/mistral-vibe/todo.md

* add mistral ai vibe to doc

* added black and white versions

* update whiteblack logos

* add vibe to carousel

* swap light dark

---------

Co-authored-by: jaccolor <jac_color@protonmail.com>
Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>

pandora · 2026-01-23 10:27:41 -05:00

a88b0c8f56

Add pi to adoption section (#70 )

Co-authored-by: Michael Renner <terrorobe@github.com>
Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>

Duncan Ogilvie · 2026-01-22 15:34:04 -05:00

ed20f3a0bf

Add Firebender logo (#72 )

* Add Firebender logo

Adds logo for android focused coding agent, Firebender that supports skills

Resolves #71

🤖 Generated with [Firebender](https://firebender.com)

Co-Authored-By: Firebender <help@firebender.com>

* fix: replace low-res Firebender SVG logos with high-resolution versions

Updated both light and dark wordmark SVGs with high-resolution exports from Figma.
Old viewBox: ~145x18 / 161x20
New viewBox: 2151x267

This addresses the resolution concerns in PR feedback.

🤖 Generated with [Firebender](https://firebender.com)

Co-Authored-By: Firebender <help@firebender.com>

---------

Co-authored-by: Firebender <help@firebender.com>

Kevin Tang · 2026-01-22 15:31:55 -05:00

640a47caee

Add Piebald (#47 )

* Add Piebald

* Move logo to avoid conflicts with other PRs

bl-ue · 2026-01-22 15:29:58 -05:00

13898cd390

Add Command Code logo (#37 )

* Add Command Code logo

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add Command Code logo

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* improve width

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Saqib Ameen <saqib1@ualberta.ca>
Co-authored-by: Saqib Ameen <mrsaqibameen@gmail.com>

Ahmad Awais · 2026-01-22 15:27:59 -05:00

2ecf167fcb

Add Databricks logo (#96 )

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>

willtipt-db · 2026-01-21 10:30:21 -05:00

007d907dba

docs: add Mux logo to adoption carousel (#76 )

Michael Suchacz · 2026-01-21 10:23:44 -05:00

8175c70fbf

Add Agentman logo to adoption carousel (#91 )

Agentman is an agentic AI platform that natively supports Agent Skills,
enabling users to build AI agents with skill-based capabilities.

Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>

prasadt3 · 2026-01-21 10:19:39 -05:00

676b661a51

Add TRAE logo to logo carousel (#88 )

Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>

Amber Shen · 2026-01-21 10:18:37 -05:00

3837202cce

Add Spring AI logo to adoption carousel (#85 )

Spring AI has integrated Agent Skills support through the spring-ai-agent-utils
project, providing tool-based integration via the SkillsTool component. This
enables Java and Spring AI agents to discover and execute skills dynamically.

Integration details: https://github.com/spring-ai-community/spring-ai-agent-utils/blob/main/spring-ai-agent-utils/docs/SkillsTool.md
Blog post: https://spring.io/blog/2026/01/13/spring-ai-generic-agent-skills

Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>

Christian Tzolov · 2026-01-21 10:15:19 -05:00

b714778c0e

Added logo for Gemini CLI (#77 )

* Add Gemini CLI logo to LogoCarousel

* Fix: swap light and dark logo filenames

Dmitry Lyalin · 2026-01-08 18:45:34 -05:00

af48a3a945

Add logo carousel (#69 )

Eric Harmeling · 2026-01-06 14:07:13 -05:00

da24a2bd17

Add Factory logo (#62 )

Eric Harmeling · 2026-01-04 11:10:57 -05:00

3c2deca383

Add OAI Codex logo (#16 )

Eric Harmeling · 2025-12-19 16:27:38 -05:00

75287b28fb

Fix vscode wordmark (#7 )

* Fix vscode wordmark

* Final wordmark

Harald Kirschner · 2025-12-19 10:56:38 -05:00

47848e1e22

Make docs mobile-responsive (#6 )

Eric Harmeling · 2025-12-18 14:24:04 -05:00

085907c589

Replace Block logo with Goose logo in docs (#5 )

Eric Harmeling · 2025-12-18 13:49:26 -05:00

7b3e7305c6

Wording updates (#4 )

Mahesh Murag · 2025-12-18 12:02:02 -05:00

891312a90a

Document reference SDK (#3 )

* Document reference SDK

* Update docs/integrate-skills.mdx

Co-authored-by: Keith Lazuka <klazuka@anthropic.com>

---------

Co-authored-by: Keith Lazuka <klazuka@anthropic.com>

Eric Harmeling · 2025-12-18 10:19:21 -05:00

f990ba148d

Add documentation

Eric Harmeling · 2025-12-18 08:46:08 -05:00

fb08d608bc

40 Commits