docs: add AI skills page

[sunder-ch]

What

Adds a new Skills page to the AI section (/ai/plane-ai-skills), alongside the existing Plane AI and AI credits pages.

Skills are saved, reusable instructions for Plane AI that users run with a / command in chat. The page covers:

• What skills are and how to use one in chat
• The built-in skills that ship with Plane (/standup, /cycle-report, /file-bug, etc.)
• Creating your own skill, with tips for writing good instructions and a worked example
• {{variable}} placeholders
• Personal vs. workspace skills and who can manage each
• Notes on limits and permissions (8,000-char instructions, one skill per message, no access expansion, guests excluded)

Changes

• New page: docs/ai/plane-ai-skills.md
• Sidebar entry in docs/.vitepress/config.ts under AI, between Plane AI and AI credits

pnpm check:format and pnpm build pass locally.

Summary by CodeRabbit

• New Features
  • Added a dedicated documentation page explaining Plane AI skills, including built-in and custom skills.
  • Documented how to use skills with the / command, create custom skills, and apply templates and variables.
  • Added the new “Skills” page to the AI documentation navigation.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 11, 2026 10:02am

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds a Plane AI skills documentation page covering usage, built-in and custom skills, variables, permissions, and constraints, then links the page from the AI sidebar.

Changes

AI Skills Documentation

Layer / File(s)	Summary
Skills page and sidebar navigation docs/ai/plane-ai-skills.md, docs/.vitepress/config.ts	Adds comprehensive Skills documentation and a new AI sidebar entry linking to the page.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• makeplane/docs#450: Updates the same VitePress AI sidebar configuration.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the main change: adding a new AI skills documentation page.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/add-ai-skills-page

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/ai/plane-ai-skills.md`:
- Around line 22-24: Update both fenced code blocks in the documentation
examples, including the slash-command example and the instruction example near
the referenced section, to specify the text language. Preserve their contents
unchanged while adding the text fence language marker to satisfy markdownlint
MD040.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9dd92ba3-9e17-41ba-a691-aa1580639671

📥 Commits

Reviewing files that changed from the base of the PR and between 223d473 and f76f4bc.

📒 Files selected for processing (2)

• docs/.vitepress/config.ts
• docs/ai/plane-ai-skills.md

[coderabbitai]

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Specify a language for both fenced code blocks.

These fences trigger markdownlint MD040. Use text for the slash command and instruction example.

Proposed fix

-```
+```text
 /cycle-report Sprint 42

...
- +text
Draft release notes from the work items completed in the cycle I mention.

</details>







Also applies to: 73-80

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 markdownlint-cli2 (0.22.1)</summary>

[warning] 22-22: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

</details>

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @docs/ai/plane-ai-skills.md around lines 22 - 24, Update both fenced code
blocks in the documentation examples, including the slash-command example and
the instruction example near the referenced section, to specify the text
language. Preserve their contents unchanged while adding the text fence language
marker to satisfy markdownlint MD040.

</details>

<!-- fingerprinting:phantom:triton:luna -->

<!-- cr-indicator-types:potential_issue -->

<!-- cr-comment:v1:ee9f9bca4767f862c8f211c5 -->

_Source: Linters/SAST tools_

<!-- This is an auto-generated comment by CodeRabbit -->