{"aiPlatform":"claude-code@2025.06","category":"development","commandName":"/build-command","content":"---\nname: Smart Command Builder\ndescription: Intelligent command generator that creates complete Commands.com-compatible commands from task descriptions. Analyzes available MCP servers to recommend optimal combinations, generates proper commands.yaml entries, and creates all necessary files for immediate Commands.com integration via GitHub.\nallowed_tools:\n  - mcp__commands-com_mcp-server    # MCP discovery and Commands.com integration\n  - filesystem                     # File creation and directory management\n---\n\n## Arguments\n\n```\n/build-command \ntask_description=\"<describe what you want the command to do>\"\n[command_name=<auto-generated|custom-name>]\n[category=<auto|development|content-creation|api-tools|security-audit>]\n[complexity=<simple|medium|advanced>]\n[include_examples=<yes|no>]\n[learning_mode=<yes|no>]\n```\n*Defaults → `command_name=auto-generated  category=auto  complexity=medium  include_examples=yes  learning_mode=yes`*\n\n### Example\n\n```\n/build-command \ntask_description=\"Create a tool that scrapes website data and analyzes it for insights with database storage\"\ncategory=development\ncomplexity=advanced\n```\n\n---\n\n## Context – what the AI should do\n\n1. **Parse Arguments and Initialize**\n   * `task_description` - Core functionality the user wants\n   * `command_name` - Generate kebab-case name or use provided\n   * `category` - Auto-detect or use specified category\n   * `complexity` - Determines feature richness and MCP selection\n   * `include_examples` - Whether to generate usage examples\n   * `learning_mode` - Whether to analyze existing patterns\n\n2. **MCP Server Discovery and Selection**\n   * Call `/mcp__commands-com_mcp-server__get_mcp_servers` to get available MCPs\n   * **Task Analysis**: Parse task description for keywords and requirements\n   * **Smart MCP Matching**:\n     - Web/scraping tasks → `puppeteer`, `filesystem`\n     - Code analysis → `github`, `filesystem`, `sqlite`\n     - API/data tasks → `filesystem`, `sqlite`\n     - File processing → `filesystem`\n     - Always add `filesystem` for file operations\n   * **Complexity Considerations**:\n     - Simple: 1-2 MCPs, basic functionality\n     - Medium: 2-3 MCPs, moderate features\n     - Advanced: 3-4 MCPs, comprehensive capabilities\n\n3. **Command Structure Generation**\n   * Call `/mcp__commands-com_mcp-server__get_commands_yaml_guide` for proper formatting\n   * Generate unique command name (kebab-case) if not provided\n   * Auto-categorize based on task description and MCP selection\n   * Create parameter schema based on task requirements\n\n4. **Conflict Prevention and Validation**\n   * Call `/mcp__commands-com_mcp-server__list_assets` to check existing user commands\n   * Ensure no naming conflicts with user's existing assets\n   * Validate command name follows conventions (kebab-case, descriptive)\n\n5. **Content Generation**\n   * **command.md**: Complete command implementation following Commands.com patterns\n     - Proper YAML frontmatter with description and allowed_tools\n     - Arguments section with examples\n     - Detailed step-by-step implementation context\n     - MCP-specific function calls and workflows\n   * **README.md**: User documentation with installation and usage\n   * **Preview placeholder**: Note about thumbnail generation\n\n6. **Commands.yaml Integration**\n   * Read existing `/filesystem__read_file path=commands.yaml`\n   * Parse current structure and metadata\n   * Generate new command entry with all required fields\n   * Update metadata (increment total_commands, update timestamp)\n   * Write updated commands.yaml back to filesystem\n\n7. **File System Operations**\n   * Create command directory: `/filesystem__create_directory path=./{command-name}`\n   * Write command.md: `/filesystem__write_file path=./{command-name}/command.md`\n   * Write README.md: `/filesystem__write_file path=./{command-name}/README.md`\n   * Update commands.yaml: `/filesystem__write_file path=./commands.yaml`\n\n8. **Quality Assurance and Validation**\n   * Call `/mcp__commands-com_mcp-server__validate_commands_yaml` with generated YAML\n   * Validate all generated files follow Commands.com specifications\n   * Check for errors, warnings, and suggestions from validation\n   * Retry generation if critical errors are found\n   * Ensure proper markdown formatting and YAML structure\n\n9. **Learning Mode (Optional)**\n   * If `learning_mode=yes`, analyze patterns from existing commands\n   * Look for similar task descriptions in trending commands\n   * Adapt successful patterns to new command generation\n\n10. **Final Output and Summary**\n    * Generate summary of created files and validation results\n    * Provide clear next steps: commit to GitHub, then manually import to Commands.com\n    * Include any validation warnings or suggestions for improvement\n    * Note that Commands.com only auto-updates existing commands, not new ones\n\n> Focus on creating production-ready commands that follow Commands.com best practices. The generated command should be immediately usable and properly integrated into the existing command repository structure.","contentHash":"66041da2f2ae4f628c41fb9d312e15714458c83befd73818997d68e1e0c6d72a","copies":2,"createdAt":"2025-07-03T04:08:30.490Z","description":"Intelligent command generator that creates complete Commands.com-compatible commands from task descriptions","displayName":"Smart Command Builder","downloads":14,"github":{"lastSyncDirection":"from-github","lastSyncError":"Failed to sync YAML command: Failed to extract file contents: logger.logProgress is not a function","repoUrl":"https://github.com/Commands-com/ai-commands","metadata":{"importedFrom":"github_repository","repoPrivate":true,"repoDefaultBranch":"main","connectedAt":"2025-07-03T04:08:30.490Z"},"importedAt":"2025-07-03T04:08:30.490Z","lastSyncAt":"2025-08-17T16:56:10.955Z","fileMapping":{"license":"LICENSE","readme":"smart-command-builder/README.md","assets":[],"mainFile":"smart-command-builder/command.md","yamlPath":"commands.yaml"},"selectedCommand":"smart-command-builder","fileShas":{"mainFile":"d455e777fbd5be9bacdea55f144d1716b8a0d41d","yamlPath":"4507cfda9afa7474437ab79914331e61ec82f4f7","readme":"1754c20f9b810709ec4182fba9e709ee71d57573"},"branch":"main","connectionType":"commands_yaml","connected":true,"lastSyncCommit":"3f1460bda072265aa9ad932490481f0843dc66f8","importSource":"repository_import","installationId":"69232615","syncStatus":"synced"},"githubRepoUrl":"https://github.com/Commands-com/ai-commands","inputParameters":[{"name":"task_description","description":"Describe what you want the command to accomplish","label":"Task Description","type":"text","required":true,"defaultValue":""},{"name":"command_name","description":"Desired name for the command (auto-generated if not provided)","label":"Command Name","type":"text","required":false,"defaultValue":""},{"defaultValue":"auto","name":"category","options":["auto","development","content-creation","api-tools","security-audit"],"description":"Primary category for the command","label":"Category","type":"select","required":false},{"defaultValue":"medium","name":"complexity","options":["simple","medium","advanced"],"description":"Desired complexity and feature richness","label":"Complexity Level","type":"select","required":false},{"defaultValue":"yes","name":"include_examples","options":["yes","no"],"description":"Generate usage examples and sample outputs","label":"Include Examples","type":"select","required":false},{"defaultValue":"yes","name":"learning_mode","options":["yes","no"],"description":"Analyze similar commands to optimize the generated command","label":"Learning Mode","type":"select","required":false}],"instructions":"# Smart Command Builder\n\nAn intelligent command generator that creates complete Commands.com-compatible commands from simple task descriptions. This tool leverages the Commands.com MCP server to discover available capabilities and generate professional-quality command implementations.\n\n## What It Does\n\nThe Smart Command Builder takes a task description and automatically:\n\n- **Analyzes** your requirements and selects optimal MCP server combinations\n- **Generates** complete command implementations with proper formatting\n- **Creates** all necessary files for Commands.com integration\n- **Updates** your commands.yaml with the new command entry\n- **Ensures** no naming conflicts with your existing commands\n\n## Key Features\n\n- **Intelligent MCP Selection**: Automatically chooses the best MCP servers for your task\n- **Complete File Generation**: Creates command.md, README.md, and updates commands.yaml\n- **Conflict Prevention**: Checks your existing Commands.com assets to avoid name conflicts\n- **Professional Quality**: Follows Commands.com best practices and formatting standards\n- **Immediate Integration**: Generated commands are ready for GitHub → Commands.com import\n\n## Usage\n\n```bash\n/build-command task_description=\"Create a tool that analyzes website performance and generates optimization reports\"\n```\n\n### Parameters\n\n- **task_description** (required): Describe what you want the command to do\n- **command_name** (optional): Custom name for the command (auto-generated if not provided)\n- **category** (optional): Command category (auto-detected if not specified)\n- **complexity** (optional): simple, medium, or advanced (affects feature richness)\n- **include_examples** (optional): Whether to include usage examples (default: yes)\n- **learning_mode** (optional): Analyze existing patterns for better generation (default: yes)\n\n### Examples\n\n#### Simple File Processing Command\n```bash\n/build-command task_description=\"Convert CSV files to JSON format with data validation\"\n```\n\n#### Advanced Web Analysis Tool\n```bash\n/build-command \ntask_description=\"Analyze website accessibility, performance, and SEO metrics\"\ncategory=development\ncomplexity=advanced\n```\n\n#### API Documentation Generator\n```bash\n/build-command \ntask_description=\"Generate comprehensive API documentation from OpenAPI specs\"\ncommand_name=\"api-doc-generator\"\ncategory=api-tools\n```\n\n## How It Works\n\n1. **Task Analysis**: Parses your description to understand requirements\n2. **MCP Discovery**: Queries available MCP servers and their capabilities\n3. **Smart Matching**: Selects optimal MCP combinations based on task needs\n4. **Structure Generation**: Creates proper Commands.com command structure\n5. **File Creation**: Generates all necessary files with professional formatting\n6. **Integration**: Updates your commands.yaml for seamless Commands.com import\n\n## MCP Server Requirements\n\nThis command requires only the **Commands.com MCP server** (`commands-com/mcp-server`), which provides:\n\n- Access to available MCP servers and their capabilities\n- Commands.com formatting guidelines and specifications\n- Your existing asset information for conflict prevention\n- Intelligence for optimal MCP server selection\n\n## Generated Files\n\nAfter running the command, you'll have:\n\n```\nyour-new-command/\n├── command.md          # Complete command implementation\n├── README.md          # User documentation\n└── preview.png        # Thumbnail placeholder\n\ncommands.yaml          # Updated with new command entry\n```\n\n## Next Steps\n\n1. **Review** the generated command files\n2. **Test** the command locally if desired\n3. **Commit** changes to your Git repository\n4. **Push** to GitHub\n5. **Import to Commands.com**: Go to Commands.com and manually import your new command from your GitHub repository (Commands.com only auto-updates existing commands, not new ones)\n\n## Tips for Best Results\n\n- **Be specific** in your task description\n- **Mention key technologies** if relevant (e.g., \"React\", \"Python\", \"REST API\")\n- **Specify data sources** if applicable (e.g., \"GitHub repositories\", \"CSV files\")\n- **Include output format** preferences (e.g., \"save to CSV files\", \"store in database\", \"generate markdown reports\")\n\n## Examples of Task Descriptions\n\n- \"Analyze code quality and security vulnerabilities in GitHub repositories\"\n- \"Scrape website data and save structured results to a database\"\n- \"Generate comprehensive API documentation from code repositories\"\n- \"Process CSV files and transform data with validation and reporting\"\n- \"Automate repository analysis and generate development reports\"\n- \"Extract data from multiple websites and compile comparison reports\"\n- \"Analyze database schemas and generate optimization recommendations\"\n\nThe more specific your description, the better the generated command will match your needs!","isPublic":true,"lastCopied":"2025-09-02T09:01:54.055Z","lastDownloaded":"2025-11-28T13:56:43.814Z","lastStarred":"2025-07-18T04:16:55.932Z","legacyId":"4941b384-dd30-47b9-a65e-01df9b8def3e","licenseType":"mit","mcpRequirements":[{"tier":"required","serverId":"commands-com/mcp-server"},{"tier":"required","serverId":"filesystem"}],"mcp_search_content":"docker-filesystem commands-com/mcp-server","organizationUsername":"commands-com","price":"free","processedGalleryItems":[{"s3KeyThumbnail":"processed/4941b384-dd30-47b9-a65e-01df9b8def3e/1751515711404_preview_thumb.webp","s3KeyLarge":"processed/4941b384-dd30-47b9-a65e-01df9b8def3e/1751515711404_preview.webp","name":"1751515711404_preview.webp","originalKey":"temp-uploads/4941b384-dd30-47b9-a65e-01df9b8def3e/1751515711404_preview.png","pathLarge":"4941b384-dd30-47b9-a65e-01df9b8def3e/1751515711404_preview.webp","type":"image/webp","pathThumbnail":"4941b384-dd30-47b9-a65e-01df9b8def3e/1751515711404_preview_thumb.webp"}],"search_content":"smart command builder intelligent command generator that creates complete commands.com-compatible commands from task descriptions /smart-command-builder code-generation claude","stars":1,"title":"Smart Command Builder","type":"command","updatedAt":"2025-08-17T16:56:10.955Z","userId":"W0V8NAw5AhWRwcuwSoFLOi1Yem83","visibility":"public","name":"smart-command-builder","userInteraction":{"userHasStarred":false},"id":"4941b384-dd30-47b9-a65e-01df9b8def3e"}