dart-dart-format
To format Dart code consistently, run `dart format .` on the given roots to apply standard formatting.
When & Why to Use This Skill
The dart-dart-format skill is a specialized MCP tool designed to automate Dart code formatting. By leveraging the official `dart format` command, it ensures your codebase remains consistent, readable, and compliant with standard Dart style guidelines. This skill eliminates manual formatting tasks, allowing developers to focus on logic while maintaining high code quality across multiple project roots and subdirectories.
Use Cases
- Standardizing Dart Codebases: Automatically apply the official Dart style guide to ensure consistent indentation, spacing, and line breaks across all source files.
- Streamlining Code Reviews: Reduce 'nitpick' comments in code reviews by programmatically fixing formatting issues before the review process begins.
- Batch Formatting: Efficiently process multiple project roots or specific file paths within a workspace to maintain a clean and professional code structure.
| name | dart-dart-format |
|---|---|
| description | "To format Dart code consistently, run `dart format .` on the given roots to apply standard formatting." |
Usage
Use the MCP tool dev-swarm.request to send the payload as a JSON string:
{"server_id":"dart","tool_name":"dart_format","arguments":{}}
Tool Description
Runs dart format . for the given project roots.
Arguments Schema
The schema below describes the arguments object in the request payload.
{
"type": "object",
"properties": {
"roots": {
"type": "array",
"title": "All projects roots to run this tool in.",
"items": {
"type": "object",
"properties": {
"root": {
"type": "string",
"title": "The file URI of the project root to run this tool in.",
"description": "This must be equal to or a subdirectory of one of the roots allowed by the client. Must be a URI with a `file:` scheme (e.g. file:///absolute/path/to/root)."
},
"paths": {
"type": "array",
"title": "Paths to run this tool on. Must resolve to a path that is within the \"root\".",
"items": {
"type": "string"
}
}
},
"required": [
"root"
]
}
}
}
}
Background Tasks
If the tool returns a task id, poll the task status via the MCP request tool:
{"server_id":"dart","method":"tasks/status","params":{"task_id":"<task_id>"}}