more skills work

Author: lmajano

commands/coldbox/ai/skills/create.cfc

@@ -5,6 +5,7 @@
  * Examples:
  * coldbox ai skills create api-development
  * coldbox ai skills create testing-patterns --open
+ * coldbox ai skills create payment-processing --cfml
  */
 component extends="coldbox-cli.models.BaseAICommand" {
 
@@ -15,20 +16,27 @@ component extends="coldbox-cli.models.BaseAICommand" {
 	 * Run the command
 	 *
 	 * @name The custom skill name
+	 * @boxlang Use BoxLang syntax (default)
+	 * @cfml Use CFML syntax
 	 * @open Open the created file in the default editor
 	 * @directory The target directory (defaults to current directory)
 	 */
 	function run(
 		required string name,
+		boolean boxlang  = true,
+		boolean cfml     = false,
 		boolean open     = false,
 		string directory = getCwd()
 	){
 		showColdBoxBanner( "Create Custom Skill" )
 
 		ensureInstalled( arguments.directory )
 
+		// Determine language (cfml flag overrides boxlang)
+		var language = arguments.cfml ? "cfml" : "boxlang"
+
 		print.line()
-		printInfo( "Creating custom skill: #arguments.name#" )
+		printInfo( "Creating custom skill: #arguments.name# (#uCase(language)#)" )
 		print.line()
 
 		// Check if already exists
@@ -47,7 +55,8 @@ component extends="coldbox-cli.models.BaseAICommand" {
 		// Create skill from template
 		variables.skillManager.createCustomSkill(
 			arguments.directory,
-			arguments.name
+			arguments.name,
+			language
 		)
 
 		// Regenerate agent files

commands/coldbox/ai/skills/help.cfc

@@ -26,8 +26,11 @@ component excludeFromHelp=true extends="coldbox-cli.models.BaseCommand" {
 			.dim( "  ## List all skills" )
 			.line( "  coldbox ai skills list" )
 			.line()
-			.dim( "  ## Create a custom deployment workflow skill" )
-			.line( "  coldbox ai skills create deployment-workflow" )
+		.dim( "  ## Create a custom deployment workflow skill (BoxLang syntax)" )
+		.line( "  coldbox ai skills create deployment-workflow" )
+		.line()
+		.dim( "  ## Create a custom skill with CFML syntax" )
+		.line( "  coldbox ai skills create payment-processing --cfml" )
 			.line()
 			.dim( "  ## Refresh skills after installing new modules" )
 			.line( "  coldbox ai skills refresh" )

models/SkillManager.cfc

@@ -104,8 +104,13 @@ component singleton {
 	 *
 	 * @directory The project directory
 	 * @name The custom skill name
+	 * @language The language variant (boxlang or cfml)
 	 */
-	function createCustomSkill( required string directory, required string name ){
+	function createCustomSkill(
+		required string directory,
+		required string name,
+		string language = "boxlang"
+	){
 		var targetDir = "#arguments.directory#/.ai/skills/custom/#arguments.name#"
 		var skillFile = "#targetDir#/SKILL.md"
 
@@ -115,7 +120,8 @@ component singleton {
 		}
 
 		// Create skill from template
-		var templatePath = variables.utility.getTemplatesPath() & "/ai/skills/custom-skill-template.md"
+		var languageSuffix = arguments.language == "cfml" ? ".cfml" : ".bx"
+		var templatePath = variables.utility.getTemplatesPath() & "/ai/skills/custom-skill-template#languageSuffix#.md"
 		var template = fileRead( templatePath )
 
 		// Replace tokens

templates/ai/skills/custom-skill-template.bx.md

@@ -0,0 +1,159 @@
+---
+name: |skillName|
+category: custom
+triggers:
+  - "Add trigger keywords here"
+  - "When implementing [feature]"
+  - "For [specific use case]"
+confidence: high
+---
+
+# |skillName| Skill
+
+## When to Use
+
+Describe when this skill should be activated. Be specific about:
+
+- User requests that should trigger this skill
+- Project contexts where this applies
+- Specific keywords or phrases that indicate this skill is needed
+
+## Implementation Pattern
+
+### Overview
+
+Provide a high-level description of the implementation approach.
+
+### Step-by-Step Guide
+
+1. **Step One**: Describe the first step
+
+   ```boxlang
+   /**
+    * Example implementation
+    */
+   class MyClass {
+
+       function init() {
+           // Implementation
+           return this
+       }
+
+       function myMethod() {
+           // Method implementation
+       }
+   }
+   ```
+
+2. **Step Two**: Describe the second step
+
+   ```boxlang
+   // More example code with BoxLang syntax
+   var result = someService.getData()
+       .filter( ( item ) => item.active )
+       .map( ( item ) => item.name )
+   ```
+
+3. **Step Three**: Continue with additional steps
+
+## Code Examples
+
+### Example 1: Basic Usage
+
+```boxlang
+/**
+ * Provide a complete, working example
+ */
+class MyHandler {
+
+    property name="userService" inject="UserService";
+
+    /**
+     * Example action
+     */
+    function index( event, rc, prc ) {
+        prc.users = userService.getAll()
+
+        event.setView( "users/index" )
+    }
+}
+```
+
+### Example 2: Advanced Pattern
+
+```boxlang
+/**
+ * Show more complex usage with BoxLang features
+ */
+class MyService {
+
+    property name="wirebox" inject="wirebox";
+
+    function processData( required array data ) {
+        return arguments.data
+            .filter( ( item ) => item.status == "active" )
+            .map( ( item ) => {
+                return {
+                    "id": item.id,
+                    "name": item.name,
+                    "processed": true
+                }
+            } )
+    }
+
+    function getRepository() {
+        return wirebox.getInstance( "MyRepository" )
+    }
+}
+```
+
+## Best Practices
+
+- Use BoxLang class syntax for modern components
+- Leverage lambda expressions for cleaner code
+- Follow BoxLang naming conventions
+- Document all public methods with JavaDoc-style comments
+- Use type hints where beneficial
+- Implement proper dependency injection
+
+## Testing Approach
+
+```boxlang
+/**
+ * Example test case using TestBox BDD
+ */
+class MyHandlerTest extends BaseTestCase {
+
+    function beforeAll() {
+        super.beforeAll()
+    }
+
+    function run() {
+        describe( "|skillName| Tests", () => {
+            it( "should implement feature", () => {
+                var result = getInstance( "MyHandler" ).index(
+                    event = getRequestContext(),
+                    rc = {},
+                    prc = {}
+                )
+
+                expect( result ).notToBeNull()
+            } )
+        } )
+    }
+}
+```
+
+## Common Mistakes
+
+- **Using component syntax instead of class**: BoxLang prefers `class` over `component`
+- **Not using lambda expressions**: Take advantage of modern functional programming
+- **Missing type hints**: While optional, type hints improve code clarity
+- **Inconsistent formatting**: Follow BoxLang style guidelines
+
+## References
+
+- Link to relevant documentation
+- Related skills
+- External resources
+- BoxLang documentation: <https://boxlang.io/docs>