Skip to content

ai-llms: document the Clever Tools skill for AI assistants - #1025

Open
LostInBrittany wants to merge 4 commits into
mainfrom
ai-llms-clever-tools-skill
Open

LostInBrittany wants to merge 4 commits into
mainfrom
ai-llms-clever-tools-skill

Conversation

@LostInBrittany

@LostInBrittany LostInBrittany commented Oct 6, 2026 •

Copy link
Copy Markdown
Collaborator

📝 Summary

This PR documents the Clever Tools skill for AI coding assistants, which the docs only mentioned in one sentence and in the 4.6 changelog. The Materia KV and logs fixes found along the way are in separate pull requests.

  • Add a "Teach your assistant Clever Tools" section to the AI & LLMs page: what the skill is, npx skills add CleverCloud/clever-tools, project or global install, npx skills list and npx skills update, and where to report issues
  • Add the skill to the interfaces table, and present it as the starting point before the MCP server
  • Point to it from the Clever Tools install page and the CLI hub
  • Fix the AI & LLMs home card subtitle, which described AI workloads rather than driving the platform from an assistant

🧪 Type of Change

  • ⚠️ Bug fix
  • 📅 Changelog update
  • 📚 Documentation update
  • ✨ New content/feature
  • 🔧 Technical/maintenance

✅ Validation

  • Read the contributing guidelines
  • Verify content accuracy and links
  • Run relevant checks and builds
  • Check the rendered result when the change affects layout or formatting

@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown

:octocat: Preview is deploying...

Please wait while the preview is deploying on Clever Cloud...

ℹ️ Name 🔗 Infos & links
🌱 Deploying commit 53c186c
👁️ Preview Generating preview app...

Copilot AI 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.

Copilot review overview

🟡 Changes recommended

The revised prose incorrectly implies that the instruction-only skill is built on @clevercloud/client.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Documents how AI coding assistants can use the Clever Tools skill and improves its discoverability.

Changes:

  • Adds skill installation, scope, maintenance, and usage guidance.
  • Links the guidance from CLI documentation.
  • Updates the AI & LLMs homepage card.
File Description
content/​doc/​manage/​cli/​install/​_index.md Adds AI assistant installation guidance.
content/​doc/​manage/​cli/​_index.md Links to the new guidance.
content/​doc/​ai-llms.md Documents the skill and interface selection.
content/​doc/​_index.md Updates the AI & LLMs card subtitle.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread content/doc/ai-llms.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

This branch was successfully deployed

1 active deployment
update doc — dddafbb7 Deployed Oct 6, 2026 by LostInBrittany via Check externally maintained guides #1641
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.

2 participants