agileflow 2.61.0 → 2.62.0

package/src/core/commands/skill/delete.md

@@ -0,0 +1,189 @@
+---
+description: Remove an installed skill from .claude/skills/
+argument-hint: [SKILL_NAME] (optional)
+---
+
+# /agileflow:skill:delete
+
+Remove a skill from `.claude/skills/`.
+
+---
+
+## Workflow
+
+### STEP 1: Select skill to delete
+
+If SKILL_NAME not provided, list available skills:
+
+```bash
+ls -d .claude/skills/*/ 2>/dev/null | xargs -I {} basename {}
+```
+
+Then ask user:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Which skill would you like to delete?",
+  "header": "Select Skill",
+  "multiSelect": false,
+  "options": [
+    {"label": "<skill-1>", "description": "<description from frontmatter>"},
+    {"label": "<skill-2>", "description": "<description from frontmatter>"},
+    {"label": "<skill-3>", "description": "<description from frontmatter>"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 2: Show skill contents
+
+Display what will be deleted:
+
+```
+⚠️  About to delete: supabase-swift
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+This will permanently remove:
+  .claude/skills/supabase-swift/
+  ├── SKILL.md
+  ├── references.md
+  ├── cookbook/
+  │   ├── crud-operations.md
+  │   └── authentication.md
+  └── .mcp.json
+
+Total: 5 files in 2 directories
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### STEP 3: Confirm deletion
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Are you sure you want to delete this skill? This cannot be undone.",
+  "header": "Confirm Delete",
+  "multiSelect": false,
+  "options": [
+    {"label": "Yes, delete permanently", "description": "Remove the skill and all its files"},
+    {"label": "No, keep it", "description": "Cancel and return"},
+    {"label": "Export first", "description": "Save a backup before deleting"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 4: Handle export (if requested)
+
+If user chose "Export first":
+
+1. Create backup directory: `.claude/skills-backup/`
+2. Copy skill to backup with timestamp:
+   ```bash
+   cp -r .claude/skills/<skill> .claude/skills-backup/<skill>-$(date +%Y%m%d-%H%M%S)/
+   ```
+3. Show backup location
+4. Return to confirmation
+
+### STEP 5: Delete skill
+
+```bash
+rm -rf .claude/skills/<skill>/
+```
+
+### STEP 6: Confirm deletion
+
+```
+✅ Deleted: supabase-swift
+
+The skill has been permanently removed from .claude/skills/
+```
+
+### STEP 7: Offer next actions
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "What would you like to do next?",
+  "header": "Next Action",
+  "multiSelect": false,
+  "options": [
+    {"label": "Delete another skill", "description": "Remove more skills"},
+    {"label": "Create new skill", "description": "Generate a replacement skill"},
+    {"label": "List remaining skills", "description": "See what's still installed"},
+    {"label": "Done", "description": "Exit skill management"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+## Backup Location
+
+Backups are stored in:
+```
+.claude/skills-backup/<skill>-<timestamp>/
+```
+
+Example:
+```
+.claude/skills-backup/supabase-swift-20251227-143052/
+├── SKILL.md
+├── references.md
+├── cookbook/
+└── .mcp.json
+```
+
+---
+
+## Error Handling
+
+### Skill Not Found
+```
+❌ Skill "<name>" not found.
+
+Available skills:
+  - ui-components
+  - api-integration
+
+Use /agileflow:skill:list to see all skills.
+```
+
+### No Skills Installed
+```
+❌ No skills to delete.
+
+No skills are currently installed in .claude/skills/
+```
+
+### Delete Failed
+```
+❌ Failed to delete skill: <error message>
+
+The skill directory may be in use or have permission issues.
+Try manually: rm -rf .claude/skills/<skill>/
+```
+
+---
+
+## Safety Features
+
+1. **Always confirm** - Never delete without explicit confirmation
+2. **Show contents** - Display exactly what will be removed
+3. **Export option** - Allow backup before deletion
+4. **No batch delete** - One skill at a time for safety
+
+---
+
+## Usage
+
+```bash
+# Interactive mode
+/agileflow:skill:delete
+
+# Delete specific skill
+/agileflow:skill:delete supabase-swift
+```

package/src/core/commands/skill/edit.md

@@ -0,0 +1,245 @@
+---
+description: Edit an existing skill's SKILL.md, cookbook entries, or references
+argument-hint: [SKILL_NAME] (optional)
+---
+
+# /agileflow:skill:edit
+
+Modify an existing skill in `.claude/skills/`.
+
+---
+
+## Workflow
+
+### STEP 1: Select skill to edit
+
+If SKILL_NAME not provided, list available skills:
+
+```bash
+ls -d .claude/skills/*/ 2>/dev/null | xargs -I {} basename {}
+```
+
+Then ask user:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Which skill would you like to edit?",
+  "header": "Select Skill",
+  "multiSelect": false,
+  "options": [
+    {"label": "<skill-1>", "description": "<description from frontmatter>"},
+    {"label": "<skill-2>", "description": "<description from frontmatter>"},
+    {"label": "<skill-3>", "description": "<description from frontmatter>"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 2: Show skill structure
+
+Display current skill contents:
+
+```
+📝 Editing: supabase-swift
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Files:
+  1. SKILL.md (main skill file)
+  2. references.md (documentation links)
+  3. cookbook/crud-operations.md
+  4. cookbook/authentication.md
+  5. .mcp.json (MCP configuration)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### STEP 3: Ask what to edit
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "What would you like to modify?",
+  "header": "Edit Target",
+  "multiSelect": false,
+  "options": [
+    {"label": "SKILL.md", "description": "Edit main skill instructions"},
+    {"label": "references.md", "description": "Update documentation links"},
+    {"label": "Cookbook entry", "description": "Edit a specific workflow"},
+    {"label": "Add new cookbook", "description": "Create a new workflow"},
+    {"label": "MCP configuration", "description": "Modify MCP server settings"},
+    {"label": "Rename skill", "description": "Change skill name and folder"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 4: Read current content
+
+Read the selected file:
+
+```bash
+cat .claude/skills/<skill>/<file>
+```
+
+### STEP 5: Ask for changes
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "How would you like to modify this file?",
+  "header": "Edit Mode",
+  "multiSelect": false,
+  "options": [
+    {"label": "Describe changes", "description": "Tell me what to change and I'll update it"},
+    {"label": "Add content", "description": "Append new sections or examples"},
+    {"label": "Replace section", "description": "Rewrite a specific section"},
+    {"label": "Full rewrite", "description": "Regenerate with research (Recommended)"},
+    {"label": "Cancel", "description": "Return without changes"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 6: Apply changes
+
+Based on user's choice:
+
+**For "Describe changes":**
+- Read current file
+- Apply user's described modifications
+- Show diff preview
+- Confirm with YES/NO
+
+**For "Full rewrite":**
+- Enter plan mode to research
+- Gather updated web docs, local docs, codebase patterns
+- Regenerate file with new research
+- Show diff preview
+- Confirm with YES/NO
+
+### STEP 7: Show diff and confirm
+
+```
+📝 Changes to SKILL.md:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+- old line
++ new line
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Apply these changes?",
+  "header": "Confirm",
+  "multiSelect": false,
+  "options": [
+    {"label": "Yes, save changes", "description": "Write the updated file"},
+    {"label": "No, discard", "description": "Cancel without saving"},
+    {"label": "Edit more", "description": "Make additional changes first"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 8: Write changes
+
+If confirmed:
+1. Write updated file
+2. Show success message
+3. Offer next actions
+
+---
+
+## Special Edits
+
+### Rename Skill
+
+1. Get new name from user
+2. Validate: letters, numbers, hyphens only
+3. Create new directory: `.claude/skills/<new-name>/`
+4. Copy all files
+5. Update `name:` in SKILL.md frontmatter
+6. Delete old directory
+7. Confirm completion
+
+### Add Cookbook Entry
+
+1. Ask for use case name
+2. Create `cookbook/<use-case>.md` from template
+3. Update SKILL.md to reference new cookbook
+4. Show diff and confirm
+
+---
+
+## Cookbook Template
+
+```markdown
+# <Use Case Title>
+
+<Brief description of this workflow.>
+
+## Prerequisites
+
+- <Prerequisite 1>
+- <Prerequisite 2>
+
+## Instructions
+
+1. **<Step 1>**:
+   <Details>
+
+2. **<Step 2>**:
+   ```<language>
+   <code example>
+   ```
+
+3. **<Step 3>**:
+   <Details>
+
+## Example
+
+**Input**: <sample>
+**Output**: <result>
+
+## Troubleshooting
+
+- **<Problem>**: <Solution>
+```
+
+---
+
+## Error Handling
+
+### Skill Not Found
+```
+❌ Skill "<name>" not found.
+
+Available skills:
+  - supabase-swift
+  - ui-components
+
+Use /agileflow:skill:list to see all skills.
+```
+
+### No Skills Installed
+```
+❌ No skills installed yet.
+
+Create a skill first: /agileflow:skill:create
+```
+
+---
+
+## Usage
+
+```bash
+# Interactive mode
+/agileflow:skill:edit
+
+# Edit specific skill
+/agileflow:skill:edit supabase-swift
+```

package/src/core/commands/skill/list.md

@@ -0,0 +1,155 @@
+---
+description: List all installed skills with their descriptions and status
+argument-hint: (no arguments)
+---
+
+# /agileflow:skill:list
+
+Display all skills installed in `.claude/skills/` with their metadata.
+
+---
+
+## Output Format
+
+```
+📦 Installed Skills (X total)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+SKILL NAME              DESCRIPTION                           FILES
+─────────────────────────────────────────────────────────────────────
+supabase-swift          Supabase database operations          4 files
+  └─ cookbook/crud-operations.md, cookbook/auth.md
+
+ui-components           React component patterns              3 files
+  └─ cookbook/create-component.md
+
+api-integration         REST API client patterns              2 files
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## Workflow
+
+### STEP 1: Check for skills directory
+
+```bash
+ls -la .claude/skills/ 2>/dev/null
+```
+
+If directory doesn't exist or is empty:
+```
+No skills installed yet.
+
+To create a skill, run: /agileflow:skill:create
+```
+
+### STEP 2: Scan each skill directory
+
+For each subdirectory in `.claude/skills/`:
+
+1. **Read SKILL.md frontmatter** to extract:
+   - `name` - skill identifier
+   - `description` - skill purpose
+
+2. **Count supporting files**:
+   - cookbook/*.md
+   - tools/*
+   - .mcp.json (if present)
+   - references.md (if present)
+
+3. **Check for MCP integration**:
+   - If `.mcp.json` exists, note "MCP: ✓"
+
+### STEP 3: Format output
+
+```
+📦 Installed Skills (3 total)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+supabase-swift                                        MCP: ✓
+  Supabase database operations for Swift apps
+  └─ 4 files: cookbook/crud.md, cookbook/auth.md, references.md, .mcp.json
+
+ui-components
+  React component patterns with accessibility
+  └─ 3 files: cookbook/create.md, cookbook/styling.md, references.md
+
+api-integration
+  REST API client patterns with error handling
+  └─ 2 files: SKILL.md, references.md
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### STEP 4: Offer next actions
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "What would you like to do?",
+  "header": "Skill Actions",
+  "multiSelect": false,
+  "options": [
+    {"label": "Create new skill", "description": "Generate a new skill with research"},
+    {"label": "Edit a skill", "description": "Modify an existing skill"},
+    {"label": "Delete a skill", "description": "Remove a skill"},
+    {"label": "Test a skill", "description": "Verify a skill works correctly"},
+    {"label": "Done", "description": "Exit skill management"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+## Skill Metadata Parsing
+
+**SKILL.md Frontmatter Example:**
+```yaml
+---
+name: supabase-swift
+description: Use when building Swift apps with Supabase database operations
+---
+```
+
+**Parse with:**
+```bash
+head -10 .claude/skills/<skill>/SKILL.md | grep -E "^(name|description):"
+```
+
+---
+
+## Error Handling
+
+### No Skills Directory
+```
+📦 No skills installed yet.
+
+Skills are stored in .claude/skills/ and can be created with:
+  /agileflow:skill:create
+
+This will research best practices and generate a contextual skill.
+```
+
+### Invalid Skill (Missing SKILL.md)
+Skip directories without SKILL.md and note:
+```
+⚠️ Skipped: <dirname>/ (missing SKILL.md)
+```
+
+### Corrupted Frontmatter
+If frontmatter can't be parsed:
+```
+⚠️ <skill>: Could not parse frontmatter
+```
+
+---
+
+## Usage
+
+```bash
+# List all installed skills
+/agileflow:skill:list
+```