docs: add custom agent skills hosting to Agent skills page#5757
docs: add custom agent skills hosting to Agent skills page#5757matlegault wants to merge 8 commits into
Conversation
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
|
|
||
| For the legacy v0.1.0 layout under `.well-known/skills/`, the manifest follows the same structure without the `$schema` field. | ||
|
|
||
| ## SKILL.md format |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'SKILL' has no definition.
|
🌿 Preview your docs: https://fern-preview-devin-1781112454-agent-skills-docs.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Co-Authored-By: mathieu <mathieu@buildwithfern.com>
devin-ai-integration
Bot
force-pushed
the
devin/1781112454-agent-skills-docs
branch
from
f9bc383 to
000e3a6
Compare
devin-ai-integration
Bot
changed the title
|
|
||
| For the legacy v0.1.0 layout under `.well-known/skills/`, the manifest follows the same structure without the `$schema` field. | ||
|
|
||
| ### SKILL.md format |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'SKILL' has no definition.
Co-Authored-By: mathieu <mathieu@buildwithfern.com>
Co-Authored-By: mathieu <mathieu@buildwithfern.com>
…ls action Co-Authored-By: mathieu <mathieu@buildwithfern.com>
| Frontmatter requirements for each `SKILL.md`: | ||
|
|
||
| | Field | Rules | | ||
| |-------|-------| |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'SKILL' has no definition.
| </ParamField> | ||
|
|
||
| <ParamField path="page-actions.options.skills.learn-more-url" type="string" required={false} toc={true}> | ||
| URL for a "Learn more" link shown alongside the description. |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[Microsoft.URLFormat] Use 'of' (not 'for') to describe the relationship of the word URL to a resource.
Co-Authored-By: mathieu <mathieu@buildwithfern.com>
…-known as secondary Co-Authored-By: mathieu <mathieu@buildwithfern.com>
| .well-known/ | ||
| agent-skills/ | ||
| index.json # discovery manifest (required) | ||
| plant-care/ |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[Microsoft.URLFormat] Use 'of' (not 'for') to describe the relationship of the word URL to a resource.
| </ParamField> | ||
|
|
||
| <ParamField path="page-actions.options.skills.learn-more-url" type="string" required={false} toc={true}> | ||
| URL for a "Learn more" link shown alongside the description. |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[Microsoft.URLFormat] Use 'of' (not 'for') to describe the relationship of the word URL to a resource.
2 participants
Summary
Documents the agent skills features from fern-platform#11973 and fern#16446. Three files changed:
agent-skills.mdx— new "Host custom skills from your docs site" section covering directory layout (both/.well-known/skills/and/.well-known/agent-skills/), discovery manifest formats (v0.2.0url+digestvs v0.1.0files[]),SKILL.mdfrontmatter validation, and published URLs. Cross-references the new page-actions config.site-level-settings.mdx— new "Install skills action" subsection under Page actions: documentspage-actions.options.skills(title, description, learn-more-url, repository, install-command, skills list). The modal fetches the well-known manifest on first open as progressive enhancement.changelog/2026-06-10.mdx— two new entries appended: "Host agent skills from your docs site" and "Install skills page action".Link to Devin session: https://app.devin.ai/sessions/8401784e03fa4046a63fe8db6db4a737
Requested by: @matlegault