102 Commits

• Merge pull request #384 from diegoalejandronavarrogonzalez-oss/fix/spec-name-field-alphanumeric-range

  docs: fix name field character range to include digits

  Jonathan Hefner · 2026-05-20 12:23:06 -05:00
  5d4c1fda3f
• Add bub to clients list (#340)

  * Add bub to client showcase
  
  Signed-off-by: Chojan Shang <psiace@apache.org>
  
  * Apply suggestions from code review
  
  Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>
  
  ---------
  
  Signed-off-by: Chojan Shang <psiace@apache.org>
  Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

  Chojan Shang · 2026-05-20 11:50:42 -05:00
  0dd34f7782
• feat: add Superconductor to clients showcase (#377)

  Adds Superconductor to the client list with a description of its
  multiplayer workspace capabilities. Includes light and dark mode
  SVG wordmarks and links to their documentation.
  
  Co-authored-by: Claude Code <noreply@anthropic.com>

  Ibrahim Awwal · 2026-05-20 11:45:06 -05:00
  873ac564e4
• Add Vita logo to Agent Skills logo carousel (#332)

  * Add Vita logo to LogoCarousel
  
  Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
  
  * docs(clients): optimize Vita description
  
  Clarify product features and values for Vita client.
  
  ---------
  
  Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

  lilac · 2026-05-19 14:53:45 -05:00
  1f2afe4d54
• Add Tabnine to client showcase (#349)

  * Add Tabnine to client showcase
  
  * Swap light and dark logo filenames

  Pavel-tabnine · 2026-05-19 14:22:06 -05:00
  19d813201a
• docs: fix name field character range to include digits

  The body text described valid characters as '(a-z)' but the summary
  table above correctly states 'Lowercase letters, numbers, and hyphens
  only'. Updated the range to '(a-z, 0-9)' for consistency.

  Diego Navarro · 2026-05-16 16:49:49 -07:00
  6868401b64
• Merge pull request #325 from jonathanhefner/evolve-landing-page

  Flesh out landing page

  Jonathan Hefner · 2026-04-22 10:19:45 -05:00
  2d3e01f590
• Scale down fast-agent logo in clients.jsx

  Reduce the `scale` from `1.8` to `1.33` to better match neighboring
  logos in the showcase. Also point `instructionsUrl` to the Agent Skills
  page on fast-agent.ai, and trim trailing whitespace.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-20 14:43:02 -05:00
  42601f8c1c
• Feat/fast agent (#327)

  * add fast-agent
  
  * add fast-agent (no colour accent)
  
  * update logo accent colours

  shaun smith · 2026-04-20 14:41:16 -05:00
  d0a85b1cc9
• Remove redundant what-are-skills.mdx

  The content of this page is now adequately represented elsewhere:
  
  - The intro, directory structure, and progressive disclosure sections
    are covered by `home.mdx` and `specification.mdx`.
  - The `SKILL.md` format details are covered by `quickstart.mdx` and
    `specification.mdx`.
  - The "key advantages" framing (self-documenting, extensible, portable)
    is either self-evident, conveyed by the directory trees in `home.mdx`
    and `specification.mdx`, or demonstrated by the Client Showcase.
  
  Also adds a redirect from `/what-are-skills` to the home page so
  existing inbound links don't break.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-19 15:25:44 -05:00
  c33d0c7f1f
• Point "progressive disclosure" links at specification.mdx

  Two links in `best-practices.mdx` and `optimizing-descriptions.mdx`
  pointed at `/what-are-skills#how-skills-work`, blocking the eventual
  removal of `what-are-skills.mdx`. Redirect them to the existing
  `## Progressive disclosure` section in `specification.mdx`, which is a
  more natural reference target for the concept.
  
  Also expand that section's lead-in from "Skills should be structured for
  efficient use of context:" to a sentence that names progressive
  disclosure as a loading mechanism, so readers who follow the link land
  on a definition rather than a bare set of structural guidelines. The
  original three-level list and `SKILL.md` line-count guidance are
  preserved unchanged.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-19 15:09:27 -05:00
  b8d2613ac0
• Remove link to what-are-skills.mdx from quickstart.mdx

  The quickstart's "How it works" section already explains progressive
  disclosure in concrete, tutorial-specific terms, so the follow-up link
  to `what-are-skills.mdx` adds little. Drop it in preparation for phasing
  out that page.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-19 14:25:01 -05:00
  8aeff47697
• Reduce "Get started" cards on home.mdx to Quickstart and Specification

  Pare the `CardGroup` from five cards across three columns down to two
  cards across two columns, keeping only Quickstart (pointing at
  `/skill-creation/quickstart`) and Specification. The "What are skills?"
  card is now redundant with the "What are Agent Skills?", "Why Agent
  Skills?", and "How do Agent Skills work?" sections above, and the "Add
  skills support", "Example skills", and "Reference library" links serve
  smaller audiences that can reach them through the sidebar.
  
  Also rename the section heading to "Get started with Agent Skills" to
  match the neighboring sections, and reword the Specification blurb to
  reference Agent Skills rather than `SKILL.md` files.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-19 14:16:05 -05:00
  092659e3ec
• Simplify LogoCarousel and rework "Adoption" section on home.mdx

  Collapse the two-row `LogoCarousel` into a single row and compute its
  scroll duration from the total cycle width using a fixed
  `PX_PER_SECOND`, so scroll speed stays consistent regardless of how many
  logos appear or how they are scaled. Drop the now-unneeded vertical
  padding on `.logo-carousel-track`.
  
  Rename the "Adoption" heading to "Where can I use Agent Skills?" and
  rewrite its blurb to point readers at the Client Showcase page, matching
  the question-led style of the neighboring sections.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-19 13:07:38 -05:00
  278196525d
• Add "How do Agent Skills work?" section to home.mdx landing page

  Adapted from the "How skills work" section of `what-are-skills.mdx`,
  with the heading reworded as a question to match the sibling sections,
  and the closing sentence rewritten to emphasize the payoff of
  progressive disclosure.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-19 12:27:22 -05:00
  c163f1af39
• Add "What are Agent Skills?" section to home.mdx landing page

  Pulls the lightweight-open-format intro, the `SKILL.md` folder
  description, and the directory tree from `what-are-skills.mdx` onto the
  landing page. Also retitles the page to "Agent Skills Overview" (with
  `sidebarTitle: "Overview"`) and refreshes the frontmatter description.
  
  This works toward letting `home.mdx` stand on its own so that
  `what-are-skills.mdx` can be phased out in the future.
  
  Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-19 11:56:09 -05:00
  f86c6bbc00
• Merge "Why" and "What" sections on home.mdx landing page

  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>

  Jonathan Hefner · 2026-04-19 11:32:42 -05:00
  2a439b80e5
• Merge pull request #314 from workshopdotai/add-workshop-client

  Add Workshop.ai to client showcase

  Jonathan Hefner · 2026-04-14 09:42:39 -05:00
  8d8fcbc69e
• Add nanobot to Agent Skills client showcase
  chengyongru · 2026-04-14 10:45:14 +08:00
  4cc096a7ab
• Add Workshop.ai to client showcase

  Workshop is a cross-platform AI coding agent (desktop, web, CLI) with
  multi-LLM support, sub-agents, custom agents, and skills.
  
  Product: https://workshop.ai/
  Skills docs: https://docs.workshop.ai/core-concepts/working-with-the-agent#create-your-own-agents
  
  > AI Disclosure: This PR was prepared with AI assistance.

  chilang · 2026-04-13 21:39:35 +01:00
  143656ccb7
• Add source code url to Google AI Edge Gallery in client list
  Jing Jin · 2026-04-10 13:40:02 -07:00
  f4f20dc8c5
• Scale down Google AI Edge Gallery logo in clients.jsx

  The logo is a 256x256 square icon with no wordmark, so at default scale
  it appears much larger than the horizontal wordmark logos used by other
  clients. Setting `scale: 0.45` brings it in line visually.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-10 09:35:47 -05:00
  acaa82180c
• Merge pull request #307 from jinjingforever/add_gallery

  Add Google AI Edge Gallery to Agent Skills client list

  Jonathan Hefner · 2026-04-10 09:24:38 -05:00
  650984699b
• Merge pull request #283 from jonathanhefner/allowed-tools-string

  Use precise type name for `allowed-tools` field

  Jonathan Hefner · 2026-04-10 09:21:31 -05:00
  1eeb1aab05
• Add Google AI Edge Gallery to Agent Skills client list
  Jing Jin · 2026-04-09 16:21:09 -07:00
  60830f1884
• Improve client descriptions and names in clients.jsx

  Update descriptions to use better-curated quotes from vendor websites.
  Also make display names more specific where the entry refers to a
  product rather than the parent company (e.g. "GitHub" → "GitHub
  Copilot", "Databricks" → "Databricks Genie Code", "Snowflake" →
  "Snowflake Cortex Code").
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-02 09:46:51 -05:00
  cbc20299ae
• Add shuffle/alphabetical toggle to ClientShowcase

  Clients are now shuffled by default so that alphabetical ordering
  doesn't unfairly prioritize certain clients. A segmented icon toggle
  (shuffle / A-Z) in the top-right corner lets users switch between
  shuffled and alphabetical order. Each click of the shuffle button
  produces a fresh random order.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-01 17:39:12 -05:00
  ee61ae3cf9
• Add Client Showcase page

  Add a dedicated page listing all clients that support the Agent Skills
  format. The `ClientShowcase` component renders the shared `clients` data
  as a 2-column grid of cards, sorted alphabetically, with each card
  showing the client logo, description, and links to setup instructions
  and source code when available.
  
  Add `"clients"` to the navigation in `docs.json`.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-01 17:38:42 -05:00
  6f18cf6609
• Extract client data from LogoCarousel into shared clients.jsx

  Move the hardcoded client data array out of `LogoCarousel.jsx` into a
  separate `docs/snippets/clients.jsx` module so it can be reused by other
  components. `LogoCarousel` now accepts a `clients` prop, and `home.mdx`
  imports and passes the shared data. Also extract a `Logo` sub-component
  to reduce duplication of the light/dark `<img>` pair.
  
  Update `CONTRIBUTING.md` to point contributors to `clients.jsx`.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-01 15:15:26 -05:00
  b10b93a438
• Override Mintlify's default <img> margins in logo carousel

  Mintlify adds 36px top and bottom margins to `<img>` elements in the
  main content area. This caused unwanted vertical spacing in the logo
  carousel rows. Adding `!my-0` to each `<img>` removes those margins.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-01 15:08:19 -05:00
  ee7d80cb8b
• Move logo sizing from <img> to wrapper <div> in logo carousel

  Use a wrapper `<div>` to control each logo's width instead of styling
  the `<img>` elements directly. This also replaces inline styles on the
  `<a>` elements with Tailwind utility classes (`no-underline`,
  `border-none`) and simplifies the map callbacks.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-01 15:08:19 -05:00
  15ddb74928
• Replace per-logo width with relative scale in logo carousel

  The logo carousel previously used a per-logo `width` property (e.g.
  `"120px"`, `"200px"`) with a fallback default of `"150px"`. This made
  logo sizing an absolute, context-specific value tied to the carousel
  layout.
  
  Replace `width` with a relative `scale` multiplier (e.g. `0.8`, `1.33`)
  that each consuming component can apply to its own base width. This
  prepares for sharing the logo data array between `LogoCarousel` and
  other components, where the base width might differ. Logos without a
  `scale` property default to 1.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-04-01 09:35:16 -05:00
  8c2596540b
• Add description field to each logo carousel entry

  Vendor descriptions sourced verbatim from each client's own website or
  GitHub repository. The `description` field is placed immediately after
  `name` in each entry, grouping identity metadata together.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-30 16:19:07 -05:00
  15065098a2
• Update OpenHands URL from all-hands.dev to openhands.dev

  The old URL `https://www.all-hands.dev/` now redirects to
  `https://openhands.dev/`.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-30 16:02:52 -05:00
  028a8fef9b
• Use precise type name for allowed-tools field

  Replace "space-delimited list" with "space-separated string" in both the
  frontmatter table and the `allowed-tools` field section. This better
  reflects that the value is a YAML scalar, per the given example.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-30 12:11:35 -05:00
  6f92fcdb78
• Merge pull request #279 from jonathanhefner/fix-carousel-logo-takeover

  Add `noZoom` to logo carousel images

  Jonathan Hefner · 2026-03-27 12:12:41 -05:00
  5e7f3e2c4c
• Add noZoom to logo carousel images

  Mintlify enables click-to-zoom on all `<img>` elements by default. This
  caused clicking a carousel logo to both open the vendor link in a new
  tab AND zoom the logo to fullscreen in the original tab. Adding `noZoom`
  disables the lightbox so only the link navigation fires.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-27 10:05:14 -05:00
  5343c3f42b
• Replace nested hexagon favicon with solid hexagon

  Remove the inner hexagon path with white stroke from `docs/favicon.svg`,
  leaving a single solid black hexagon to match the updated logo.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-27 09:30:13 -05:00
  85ef34c715
• Replace shuf with $RANDOM in quickstart for broader compatibility

  `shuf` is a GNU coreutil which requires `brew install coreutils` on
  macOS. Replace it with `echo $((RANDOM % <sides> + 1))` which works in
  bash and zsh on both Linux and macOS.
  
  Also reword "true randomness" to "using a random number generator" to
  more clearly distinguish programmatic RNG from LLM non-determinism.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-23 11:25:26 -05:00
  d7dba49441
• Merge pull request #274 from jonathanhefner/discord-link

  Add Discord links to `README.md` and `docs/home.mdx`

  Jonathan Hefner · 2026-03-23 10:44:50 -05:00
  d91d26d0ab
• Add Discord links to README.md and docs/home.mdx

  Adds a Discord entry to the Getting Started list in `README.md` and
  replaces the standalone "View on GitHub" link in `docs/home.mdx` with a
  sentence inviting readers to join on GitHub or Discord.
  
  Also applies minor formatting cleanup in `README.md`: bolds the link
  text and switches hyphens to em dashes for consistency.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-23 10:41:25 -05:00
  84672e62b9
• Merge pull request #261 from nairteashop/add-kiro-logo

  Add Kiro logo to carousel.

  Jonathan Hefner · 2026-03-20 10:40:12 -05:00
  2fbfc322d5
• Merge pull request #253 from jonathanhefner/compatibility-field-show-versioning

  Add runtime version example to `compatibility` field

  Jonathan Hefner · 2026-03-19 18:24:03 -05:00
  5bb99345b3
• Add Kiro logo.
  Arun Nair · 2026-03-19 16:08:01 -07:00
  cc89b9c41a
• Add runtime version example to compatibility field

  Add a third example showing a Python version requirement alongside `uv`.
  This complements the existing examples (product targeting and system
  tool requirements) by demonstrating version-pinned runtime requirements
  — the kind of non-obvious constraint that the `compatibility` field is
  useful for.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-16 12:05:26 -05:00
  99b8edf685
• Add quickstart guide for skill creators

  Adds a tutorial-style quickstart guide that walks the reader through
  creating their first Agent Skill — a `roll-dice` skill that teaches an
  agent to roll dice using true system randomness. The guide covers
  creating the `SKILL.md` file, verifying discovery via `/skills` in VS
  Code, testing with a "Roll a d20" prompt, and a brief explanation of the
  discovery/activation/execution lifecycle. Includes both bash and
  PowerShell command variants, and a note about model variation in
  tool-use reliability.
  
  Also adds the quickstart as the first page under "For skill creators" in
  `docs.json` navigation.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-16 10:35:35 -05:00
  3fccd701c1
• Merge pull request #248 from jonathanhefner/add-gotchas-section-to-best-practices

  Add gotchas section to best practices guide

  Jonathan Hefner · 2026-03-16 09:50:36 -05:00
  e42cbd6f8a
• Merge pull request #240 from jonathanhefner/clarify-skill-eval-file-tree

  Add skill directory to structure diagram in evaluating skills doc

  Jonathan Hefner · 2026-03-16 09:47:42 -05:00
  5cd19050c9
• Add gotchas section to best practices guide

  Add a new "Gotchas sections" subsection to "Patterns for effective
  instructions" in the best practices guide. Covers what a gotcha is
  (environment-specific facts that defy reasonable assumptions), how to
  structure them (problem/correction pairs), and why they belong directly
  in `SKILL.md` rather than a separate reference file.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-15 17:32:38 -05:00
  4be62ebad0
• Add skill directory to structure diagram in evaluating skills doc

  Show `csv-analyzer/` (containing `SKILL.md` and `evals/evals.json`)
  alongside `csv-analyzer-workspace/` so readers can see the full layout
  at a glance.
  
  Closes #238. Closes #239.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-13 10:59:58 -05:00
  7d9e51a92a