Skip to main content
Custom skills are workspace-private instruction packages that you create and control. They encode your organization’s specific knowledge—coding standards, review checklists, compliance rules, operational procedures—so AI agents apply them consistently across every task.

​
What you get

  • Enable/disable skills per workspace without deleting them
  • Feature assignment to scope skills to Code Review, Incident, Assessment, or any combination
  • Two creation paths: AI generation or manual writing
  • Detail view with file tree and rendered markdown preview
  • AI-powered editing to refine skills after creation

​
Prerequisites

  • A CloudThinker workspace

​
Quick start

1

Open Customize

Navigate to Customize from the sidebar menu to access the Skills management page.
2

Create a new skill

Click New Skill and choose a creation method—write instructions or generate with AI.
3

Enable and assign

Toggle the skill on and select which features should use it (Code Review, Incident, Assessment).
Custom Skills management page showing skill cards with enable toggles and feature assignment checkboxes

​
Creating a skill

Click New Skill to see the available creation methods.
New Skill dropdown showing creation options: Create with AI, Write skill instructions
Describe what you need in plain language and let AI generate a complete SKILL.md for you.
  1. Click Create with AI
  2. A chat session opens with the skill creation agent
  3. Describe your requirements—coding standards, review rules, procedures
  4. The agent generates a SKILL.md with proper frontmatter and structured instructions
  5. Review the generated skill and click Save
This is the fastest way to get started. You can always refine the skill later using AI editing.

​
Managing skills

Once created, you can manage skills from the Custom Skills page.

​
Enable or disable

Toggle a skill on or off using the switch on its card. Disabled skills are preserved but not loaded by agents.

​
Assign to features

Use the feature checkboxes on each skill card to control where it applies:
  • Code Review — applied during PR analysis
  • Incident — applied during incident investigation and RCA
  • Assessment — applied during infrastructure assessments
A skill can be assigned to multiple features simultaneously.

​
View details

Click a skill card to open the detail view. This shows a split-pane layout with the file tree on the left and rendered markdown content on the right.
Skill detail view showing file tree and rendered markdown content in a split-pane layout

​
Edit with AI

From the detail view, click Edit with AI to open a chat session where you can refine the skill’s instructions through conversation. The AI understands the existing content and can help you restructure, expand, or simplify it.

​
Delete

Remove a skill permanently from your workspace. This action cannot be undone.

​
Tips

  • Start focused — a skill that does one thing well is more effective than a broad skill that covers everything loosely.
  • One domain per skill — separate security rules from performance guidelines. This lets you assign them independently to different features.
  • Use concrete examples — agents follow examples more reliably than abstract rules. Include sample code, expected outputs, or decision tables.
  • Iterate with AI — use AI editing to refine skills over time based on review results and team feedback.
  • Test before deploying — enable a skill on a single feature first and review the agent’s output before assigning it broadly.

​
Next steps

Skill Format

Learn the SKILL.md file structure, frontmatter reference, and best practices for writing effective instructions.

Skills Overview

Understand how skills fit into the CloudThinker platform and agent workflow.