chore: style edits for assistant skills - #6369
Conversation
Align the assistant skills page (added in #6363) with docs style standards: tighter intro without promotional language, language tag on the directory tree code block, active voice, prose instead of a behavior bullet list, and action-oriented headings. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
1 participant
Documentation changes
Brief description of what's being updated
Closes
For Reviewers
When reviewing documentation PRs, please consider:
✅ Technical accuracy
✅ Clarity and completeness
✅ User experience
Note
Low Risk
Docs-only wording and layout changes with no runtime or product behavior changes.
Overview
assistant/customize.mdxmoves the pointer to skills out of inline prose into a Tip component, framed as topic-specific guidance loaded only when a question matches.assistant/skills.mdxis a broader editorial pass: refreshed frontmatter description, tighter intro and “use skills” bullets, clearer file-structure andskill.mdexamples, and wording that says redeploy instead of “publish your docs” / “discovered on your next documentation update.” The How the assistant uses skills section is rewritten as short paragraphs (no bullet list) and no longer names theloadSkilltool explicitly. Skill authoring tips is renamed Write effective skills with simplified bullets. Disable skills now documents deleting.mintlify/assistant/skills/and redeploying before contacting support.Reviewed by Cursor Bugbot for commit 9c87ec7. Bugbot is set up for automated code reviews on this repo. Configure here.