104 Commits

This Branch

This Branch

All Branches

• 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
• Merge pull request #315 from chengyongru/add-nanobot-client

  Add nanobot to Agent Skills client showcase

  Jonathan Hefner · 2026-04-14 09:38:58 -05:00
  4ae320a9f2
• 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
• Merge pull request #310 from jinjingforever/gallery_add_src

  Add source code url to Google AI Edge Gallery in client list

  Jonathan Hefner · 2026-04-10 17:51:11 -05:00
  b12d4f812c
• Add source code url to Google AI Edge Gallery in client list
  Jing Jin · 2026-04-10 13:40:02 -07:00
  f4f20dc8c5
• Merge pull request #308 from jonathanhefner/scale-edge-gallery-logo

  Scale down Google AI Edge Gallery logo in `clients.jsx`

  Jonathan Hefner · 2026-04-10 09:38:51 -05:00
  c5e183a767
• 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
• Merge pull request #291 from jonathanhefner/add-clients-page

  Add Client Showcase page

  Jonathan Hefner · 2026-04-03 09:40:55 -05:00
  2e8b326523
• 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
• Merge pull request #278 from jonathanhefner/update-favicon

  Replace nested hexagon favicon with solid hexagon

  Jonathan Hefner · 2026-03-27 12:12:17 -05:00
  662d1ccae3
• 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
• Merge pull request #275 from jonathanhefner/quickstart-use-built-in-rng

  Replace `shuf` with `$RANDOM` in quickstart for broader compatibility

  Jonathan Hefner · 2026-03-23 14:27:47 -05:00
  b5ce2a4381
• 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
• Merge pull request #250 from jonathanhefner/add-quickstart-guide

  Add quickstart guide for skill creators

  Jonathan Hefner · 2026-03-17 11:00:43 -05:00
  d723d294e8
• 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
• Merge pull request #224 from jonathanhefner/add-best-practices-guide

  Add best practices guide for skill creators

  Jonathan Hefner · 2026-03-13 12:25:50 -05:00
  36a4d328c0
• 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
• Add best practices guide for skill creators

  Covers grounding skills in real expertise (extracting from tasks,
  synthesizing from project artifacts), iterating with execution feedback,
  managing context budget, calibrating instruction specificity, and
  reusable instruction patterns (templates, checklists, validation loops,
  plan-validate-execute, script bundling).
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:19:12 -05:00
  db92534bfb
• Merge pull request #216 from jonathanhefner/clean-up-specification-doc

  Visually clean up the specification page

  Jonathan Hefner · 2026-03-10 14:18:23 -05:00
  0c61f1efc0
• Remove redundant intro sentence from specification doc

  The frontmatter `description` already serves as the page subtitle in
  Mintlify, so the "This document defines the Agent Skills format." line
  was just restating it.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:16:18 -05:00
  8c82ac2a8d
• Add ... entry to directory tree in specification doc

  The directory listing is not exhaustive — skill authors can include
  other files and subdirectories beyond those shown. Adding a `...` entry
  makes this explicit.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:16:17 -05:00
  fe28cce09e
• Move frontmatter field table above examples in specification doc

  Place the field constraints table immediately after the `Frontmatter`
  heading so readers see the reference before the examples. Also remove
  "(required)" from the heading, wrap examples in a `<Card>`, and relabel
  "With optional fields:" to "Example with optional fields:".
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:16:17 -05:00
  5d16d72435
• Add SKILL.md filename annotations to code blocks in specification doc

  The fenced code blocks showing `SKILL.md` content were labeled as `yaml`
  or plain `markdown`. Changing them to `markdown SKILL.md` adds a
  filename hint and more accurately reflects that they contain full
  `SKILL.md` snippets (including `---` frontmatter delimiters), not just
  raw YAML.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:16:17 -05:00
  7a05447ecb
• Wrap examples in <Card> components in specification doc

  The `####` field headings didn't stand out enough amongst all the code
  blocks, making the page hard to scan. Wrapping each field's examples in
  a `<Card>` draws a border around them and adds padding, so each
  subsection looks more contained instead of bleeding into the next. Also
  bolds the example labels within each card.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:16:16 -05:00
  a9d33af2d5
• Expand directory tree in specification doc

  Show optional directories (`scripts/`, `references/`, `assets/`)
  directly in the directory tree with inline annotations, replacing the
  separate `<Tip>` block.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-10 14:16:16 -05:00
  cbc354c2ff