Skip to content

Update custom modes to YAML #105

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Conversation

olearycrew
Copy link
Collaborator

@olearycrew olearycrew commented Aug 2, 2025

Closes #104

@Copilot Copilot AI review requested due to automatic review settings August 2, 2025 17:37
Copy link

vercel bot commented Aug 2, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Aug 2, 2025 5:38pm

Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR updates the custom modes documentation to transition from JSON-first to YAML-first configuration format. It significantly enhances the documentation structure to provide comprehensive guidance on creating and managing custom modes in Kilo Code.

Key changes include:

  • Introducing YAML as the preferred configuration format with comprehensive examples
  • Adding import/export functionality for sharing and backing up modes
  • Restructuring content organization with improved sections and clearer explanations


<img src="/docs/img/custom-modes/custom-modes.png" alt="Overview of custom modes interface" width="400" />
*Kilo Code's interface for creating and managing custom modes.*
<img src="/img/custom-modes/custom-modes.png" alt="Overview of custom modes interface" width="600" />
Copy link
Preview

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

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

The image path has changed from /docs/img/ to /img/. Ensure this path exists and is accessible in the documentation system, or verify that this path change is intentional and correctly reflects the new location.

Suggested change
<img src="/img/custom-modes/custom-modes.png" alt="Overview of custom modes interface" width="600" />
<img src="/docs/img/custom-modes/custom-modes.png" alt="Overview of custom modes interface" width="600" />

Copilot uses AI. Check for mistakes.

2. **Create New Mode:** Click the <Codicon name="add" /> button to the right of the Modes heading
3. **Fill in Fields:**

<img src="/img/custom-modes/custom-modes-2.png" alt="Custom mode creation interface in the Prompts tab" width="600" />
Copy link
Preview

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

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

Similar to the previous image, the path has changed from /docs/img/ to /img/. Verify that this path change is intentional and that the image is accessible at the new location.

Suggested change
<img src="/img/custom-modes/custom-modes-2.png" alt="Custom mode creation interface in the Prompts tab" width="600" />
<img src="/docs/img/custom-modes/custom-modes-2.png" alt="Custom mode creation interface in the Prompts tab" width="600" />

Copilot uses AI. Check for mistakes.

Comment on lines +123 to +125
- - edit # First element of tuple
- fileRegex: \.(md|mdx)$ # Second element is the options object
description: Markdown files only
Copy link
Preview

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

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

The YAML syntax here is confusing. The nested array structure - - edit is unusual and may not be the intended representation for the tuple format. Consider clarifying this syntax or providing a clearer example of how to represent the tuple in YAML.

Suggested change
- - edit # First element of tuple
- fileRegex: \.(md|mdx)$ # Second element is the options object
description: Markdown files only
- [edit, { fileRegex: \.(md|mdx)$, description: "Markdown files only" }]

Copilot uses AI. Check for mistakes.

Comment on lines +222 to +224
- - edit # First element of tuple
- fileRegex: \.(js|ts)$ # Second element is the options object
description: JS/TS files only
Copy link
Preview

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

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

This repeats the same confusing YAML tuple syntax. The double hyphen structure - - edit is not standard YAML and may confuse readers. Consider using a clearer representation or providing additional explanation about this specific syntax.

Suggested change
- - edit # First element of tuple
- fileRegex: \.(js|ts)$ # Second element is the options object
description: JS/TS files only
- [edit, {fileRegex: \.(js|ts)$, description: JS/TS files only}]

Copilot uses AI. Check for mistakes.

Comment on lines +349 to +351
- - edit
- fileRegex: \.(js|ts)$
description: JS/TS files only
Copy link
Preview

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

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

This is another instance of the confusing double hyphen syntax. For consistency and clarity, all tuple representations in YAML examples should use a clear, standard format that readers can easily understand and implement.

Suggested change
- - edit
- fileRegex: \.(js|ts)$
description: JS/TS files only
- edit:
- fileRegex: \.(js|ts)$
description: JS/TS files only

Copilot uses AI. Check for mistakes.

Comment on lines +365 to +366
- - edit
- fileRegex: \.py$
Copy link
Preview

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

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

Another instance of the unclear tuple syntax in YAML. This pattern appears multiple times throughout the document and should be standardized for clarity.

Suggested change
- - edit
- fileRegex: \.py$
- edit:
fileRegex: \.py$

Copilot uses AI. Check for mistakes.

Comment on lines +453 to +454
- - edit
- fileRegex: \.(test|spec)\.(js|ts)$
Copy link
Preview

Copilot AI Aug 2, 2025

Choose a reason for hiding this comment

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

Final instance of the confusing YAML tuple syntax. Consider providing a comprehensive explanation of this syntax in the document or using a more intuitive representation.

Suggested change
- - edit
- fileRegex: \.(test|spec)\.(js|ts)$
- edit:
fileRegex: \.(test|spec)\.(js|ts)$

Copilot uses AI. Check for mistakes.

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.

Update modes docs
1 participant