Commit Graph

16 Commits

Author SHA1 Message Date
mintlify[bot] af571399be docs: update A2A agent card to 0.3 schema (#6051)
* docs: update A2A agent card to 0.3 schema with supportedInterfaces

* Update ai/skillmd.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-06-02 10:22:56 -07:00
Ethan Palm aab04325b2 a2a card and discovery endpoints (#6010) 2026-05-27 16:43:15 -07:00
skeptrune 9200586a3a Boost search ranking for single-word title pages (#5670)
* docs: boost search ranking for single-word title pages

Apply `boost: 3` to English pages whose H1 / frontmatter title is a single word (e.g. "Assistant", "Quickstart", "Cards"). Short titles tend to be canonical landing pages for a topic, so users searching the exact term should land on them first.

* docs: drop boost on websocket-playground stub to keep canonical Playground ranking

`api-playground/websocket-playground.mdx` is an auto-generated AsyncAPI stub with no body content but shares the title "Playground" with `api-playground/overview.mdx`. Boosting both equally diluted the canonical overview page in search for the query "playground". Drop the boost on the stub.
2026-05-05 10:30:58 -07:00
Ethan Palm 35d6fe0252 MCP tools: query docs filesystem and skills (#5333)
* add info on skills as MCP resources

* update MCP resources/tools

* remove get_page
2026-04-13 15:26:47 -07:00
skeptrune 34058da7af test: symlinked .mintlify/skills directory (#5252)
* docs: document .mintlify/skills/ directory for multiple custom skills

* fix: indent list items inside Tip component to fix MDX parse error

* Test symlinked .mintlify/skills pointing to skills/ directory

* docs: document symlink support for .mintlify/skills directory
2026-04-09 22:15:00 -07:00
skeptrune 705ade108f docs: document .mintlify/skills/ for multiple custom skills (#5213)
* docs: document .mintlify/skills/ directory for multiple custom skills

* Add .mintlify/skills/ directory with docs and API skills

* docs: apply copy suggestions from review

* fix: indent list items inside Tip component to fix MDX parse error
2026-04-08 20:32:35 -07:00
Ethan Palm f5aa1151d0 add note about generation/update time (#4999) 2026-03-30 10:16:12 -07:00
mintlify[bot] 2a072981b4 Document agent-skills discovery endpoint (#4793)
* Document /.well-known/agent-skills discovery endpoint

Generated-By: mintlify-agent

* Update skillmd.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-23 10:14:19 -07:00
mintlify[bot] b20c661e27 Update AI feature docs and fix assistant API links (#4630)
* Update API docs: fix assistant links, document llms.txt discovery, markdown Accept header, and skills endpoints

Generated-By: mintlify-agent

* Revert translated file changes, keep English-only updates

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

* Apply suggestion from @ethanpalm

* Update llmstxt.mdx

* Update skillmd.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 16:07:14 -07:00
Ethan Palm 3dc3852b7a SEO descriptions (#4028)
* Improve SEO descriptions across 47 pages

Curated descriptions from two bot-generated PRs (#3908, #3949),
selecting the best approach for each page:
- Added missing title and description frontmatter to 10 API reference pages
- Benefit-focused descriptions for integration pages (not implementation-heavy)
- Accurate REST-aligned titles for API endpoints (Export, List, Trigger, etc.)
- Expanded short descriptions to 50–160 character range throughout

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

* copyedit

* Update custom-domain.mdx

* Fix analytics API page titles to match spec summaries

"Export" was inaccurate — spec uses "Get" for both endpoints.
Also updated descriptions to use "Retrieve" for consistency.

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-04 16:46:28 -08:00
Ethan Palm 42279d4537 Update skill.mdx example domain and remove unused import 2026-02-06 16:44:29 -08:00
Ethan Palm 74d47f50a0 Documentation edits made through Mintlify web editor 2026-01-29 10:22:34 -08:00
Ethan Palm 2953766084 Skill page copyedits (#2857)
* remove latin abbreviations

* add code example title

* vale
2026-01-25 15:31:38 -08:00
mintlify-development[bot] f48e6c5595 Document YAML frontmatter fields for custom skill.md files (#2848)
* Document YAML frontmatter fields for custom skill.md files

- Add comprehensive frontmatter documentation with all supported fields
- Clarify metadata as string key-value pairs (addresses review feedback)
- Specify allowed-tools as space-delimited experimental feature (addresses review feedback)  
- Use mintlify-docs name to avoid collisions (addresses review feedback)
- Make frontmatter requirement explicit, not optional

Addresses all feedback from PR #2847 review comments.

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

---------

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
Co-authored-by: cdxker <32852291+cdxker@users.noreply.github.com>
2026-01-23 23:23:33 -08:00
cdxker 0293134d0f Add skill.md and .well-known/skills/* reverse proxy configuration (#2790)
* Update deploy/reverse-proxy.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update deploy/reverse-proxy.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update ai/skillmd.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update ai/skillmd.mdx

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* Update deploy/reverse-proxy.mdx

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* Update deploy/reverse-proxy.mdx

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* Documentation edits made through Mintlify web editor

* move note

* add endline

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>
2026-01-22 09:49:30 -08:00
Ethan Palm 6c468efb73 Add skill.md page (#2782)
* update AI native page

* add skill.md page

* Create skill.md

* improve description

* use task-based scaffolding

* refine skill.md

* link to components overview

* add more resources
2026-01-22 09:08:11 -08:00