42 Commits

This Branch

This Branch

All Branches

• 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
• Fill in copyright holder in LICENSE appendix (#163)

  Replace the placeholder `[yyyy] [name of copyright owner]` with
  `2025 Anthropic, PBC` to match the project's origin date and maintainer.
  
  Closes #145
  
  Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-02-17 10:05:19 -06:00
  752b29a0a1
• Add CONTRIBUTING.md (#168)

  Covers types of welcome contributions (docs, bug reports, proposals),
  ecosystem listing & logo request process, development setup for the docs
  site, submitting changes, and AI contribution disclosure policy (adapted
  from the MCP project).
  
  Directs proposals and feature requests to GitHub Discussions, reserving
  Issues for bug reports. Notes that `skills-ref/` is not accepting code
  contributions and that skill submissions and major architectural changes
  are not being accepted at this time.
  
  License section reflects dual licensing: Apache 2.0 for code and spec,
  CC-BY 4.0 for documentation.
  
  Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-02-16 13:24:53 -06:00
  59b5290e10
• 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
• Use GitHub > [!IMPORTANT] callout in skills-ref/README.md (#164)

  Replace the plain bold-text blockquote with GitHub's alert syntax so the
  "not for production" notice renders with a colored icon and background,
  making it harder to miss.
  
  Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-02-15 14:41:31 -06:00
  492e1b7104
• 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
• Add top-level Apache 2.0 LICENSE and license section to README (#122)

  Add top-level LICENSE file (Apache 2.0) and a License section to
  README documenting the dual-license structure: Apache 2.0 for code,
  CC-BY-4.0 for documentation.
  
  Closes #121

  Mahesh Murag · 2026-02-05 09:18:04 -08:00
  505cd8efa8
• 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
• Add Windows installation instructions for skills-ref (#25)

  Fixes #24
  
  - Add platform-specific headers (macOS/Linux vs Windows)
  - Add PowerShell activation: .venv\Scripts\Activate.ps1
  - Add Command Prompt activation: .venv\Scripts\activate.bat
  - Cover both pip and uv installation methods

  Skill Creator · 2026-01-09 12:15:44 -05:00
  7f094a2f79
• 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 skills-ref library (#2)

  Reference library for Agent Skills with CLI and Python API:
  - validate: Check skill directories for valid SKILL.md with proper frontmatter
  - read-properties: Parse and output skill properties as JSON
  - to-prompt: Generate suggested <available_skills> XML for agent prompts
  
  🤖 Generated with [Claude Code](https://claude.com/claude-code)
  
  Co-authored-by: Claude <noreply@anthropic.com>

  Keith Lazuka · 2025-12-18 09:39:21 -05:00
  547831f3a2
• Add documentation
  Eric Harmeling · 2025-12-18 08:46:08 -05:00
  fb08d608bc
• init
  Keith Lazuka · 2025-12-16 10:48:39 -05:00
  2075f7e89f