Skip to content

Enable Install skills page action pointing at fern-api/skills#121

Open
matlegault wants to merge 2 commits into
mainfrom
matlegault/populate-docs-fern-skills
Open

Enable Install skills page action pointing at fern-api/skills#121
matlegault wants to merge 2 commits into
mainfrom
matlegault/populate-docs-fern-skills

Conversation

@matlegault

@matlegault matlegault commented Jun 11, 2026

Copy link
Copy Markdown

Adds a top-level page-actions.options.skills block to fern/docs.yml, enabling the "Install skills" page action and pointing it at Fern's own skills repo (fern-api/skills).

The modal surfaces the fern-docs skill with the npx skills add fern-api/skills --skill fern-docs install command, a "View source" link to the repo, and a "Learn more" link to the agent-skills docs. This uses the schema added in fern-api/fern#16446 and rendered by fern-api/fern-platform#11947 — once this site serves a /.well-known skills manifest, the modal will swap the hand-listed skill for the served one automatically.

🤖 Generated with Claude Code


Open in Devin Review

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 1 potential issue.

Open in Devin Review

Comment thread fern/docs.yml
Comment on lines +88 to +99
page-actions:
options:
skills:
title: Install agent skills
description: Skills for authoring Fern docs, maintained in our skills repo.
learn-more-url: https://buildwithfern.com/learn/docs/ai/agent-skills
repository: https://github.com/fern-api/skills
install-command: npx skills add fern-api/skills --skill fern-docs
skills:
- name: fern-docs
description: "Author and edit Fern documentation: MDX pages, navigation, docs.yml config, custom components, landing pages, and changelog entries."
url: https://github.com/fern-api/skills/tree/main/skills/fern-docs

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚩 Top-level page-actions key coexists with theme.page-actions

The file already has theme: page-actions: toolbar at line 85, and the PR adds a new top-level page-actions key at line 88. These are distinct YAML keys (one nested under theme, one at the root), so there's no YAML conflict. However, depending on how Fern's docs engine resolves configuration, there could be ambiguity about whether the top-level page-actions overrides or supplements theme.page-actions. The schema at https://schema.buildwithfern.dev/docs-yml.json (referenced in line 1) would clarify whether both are valid simultaneously, but it's not available locally to verify.

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

@matlegault matlegault requested a review from devalog June 12, 2026 14:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant