claude-code-orchestrator-kit 1.0.0

package/.claude/skills/format-todo-list/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: format-todo-list
+description: Generate properly formatted TodoWrite lists for orchestrator progress tracking. Use when creating phase checklists, updating task status, or ensuring consistent todo formatting.
+---
+
+# Format Todo List
+
+Create properly structured todo lists for TodoWrite tool with correct status and activeForm fields.
+
+## When to Use
+
+- Creating initial phase checklists in orchestrators
+- Updating todo list status
+- Ensuring consistent todo formatting
+- Generating progress tracking lists
+
+## Instructions
+
+### Step 1: Receive Todo Items
+
+Accept array of todo items with status.
+
+**Expected Input**:
+```json
+{
+  "todos": [
+    {
+      "content": "Phase 1: Discovery",
+      "status": "completed"
+    },
+    {
+      "content": "Phase 2: Implementation",
+      "status": "in_progress"
+    },
+    {
+      "content": "Phase 3: Validation",
+      "status": "pending"
+    }
+  ]
+}
+```
+
+### Step 2: Generate Active Forms
+
+Create activeForm for each todo based on content.
+
+**Rules**:
+- Convert imperative to present continuous
+- "Run X" → "Running X"
+- "Create X" → "Creating X"
+- "Fix X" → "Fixing X"
+- "Validate X" → "Validating X"
+
+### Step 3: Validate Status
+
+Ensure status is valid TodoWrite value.
+
+**Valid Statuses**:
+- `pending`: Not started
+- `in_progress`: Currently active
+- `completed`: Finished
+
+### Step 4: Format for TodoWrite
+
+Structure data for TodoWrite tool.
+
+**Expected Output**:
+```json
+{
+  "todos": [
+    {
+      "content": "Phase 1: Discovery",
+      "status": "completed",
+      "activeForm": "Discovering and analyzing"
+    },
+    {
+      "content": "Phase 2: Implementation",
+      "status": "in_progress",
+      "activeForm": "Implementing changes"
+    },
+    {
+      "content": "Phase 3: Validation",
+      "status": "pending",
+      "activeForm": "Validating results"
+    }
+  ]
+}
+```
+
+## Error Handling
+
+- **Invalid Status**: Return error listing valid statuses
+- **Missing Content**: Return error for empty content
+- **Empty Array**: Return error requesting at least one todo
+
+## Examples
+
+### Example 1: Phase Checklist
+
+**Input**:
+```json
+{
+  "todos": [
+    {"content": "Phase 0: Pre-flight validation", "status": "completed"},
+    {"content": "Phase 1: Bug detection", "status": "in_progress"},
+    {"content": "Phase 2: Bug fixes", "status": "pending"},
+    {"content": "Phase 3: Verification", "status": "pending"}
+  ]
+}
+```
+
+**Output**:
+```json
+{
+  "todos": [
+    {
+      "content": "Phase 0: Pre-flight validation",
+      "status": "completed",
+      "activeForm": "Validating pre-flight checks"
+    },
+    {
+      "content": "Phase 1: Bug detection",
+      "status": "in_progress",
+      "activeForm": "Detecting bugs"
+    },
+    {
+      "content": "Phase 2: Bug fixes",
+      "status": "pending",
+      "activeForm": "Fixing bugs"
+    },
+    {
+      "content": "Phase 3: Verification",
+      "status": "pending",
+      "activeForm": "Verifying fixes"
+    }
+  ]
+}
+```
+
+### Example 2: Simple Task List
+
+**Input**:
+```json
+{
+  "todos": [
+    {"content": "Run type check", "status": "completed"},
+    {"content": "Run build", "status": "completed"},
+    {"content": "Run tests", "status": "in_progress"}
+  ]
+}
+```
+
+**Output**:
+```json
+{
+  "todos": [
+    {
+      "content": "Run type check",
+      "status": "completed",
+      "activeForm": "Running type check"
+    },
+    {
+      "content": "Run build",
+      "status": "completed",
+      "activeForm": "Running build"
+    },
+    {
+      "content": "Run tests",
+      "status": "in_progress",
+      "activeForm": "Running tests"
+    }
+  ]
+}
+```
+
+### Example 3: Priority-Based List
+
+**Input**:
+```json
+{
+  "todos": [
+    {"content": "Fix critical bugs", "status": "completed"},
+    {"content": "Fix high-priority bugs", "status": "in_progress"},
+    {"content": "Fix medium-priority bugs", "status": "pending"}
+  ]
+}
+```
+
+**Output**:
+```json
+{
+  "todos": [
+    {
+      "content": "Fix critical bugs",
+      "status": "completed",
+      "activeForm": "Fixing critical bugs"
+    },
+    {
+      "content": "Fix high-priority bugs",
+      "status": "in_progress",
+      "activeForm": "Fixing high-priority bugs"
+    },
+    {
+      "content": "Fix medium-priority bugs",
+      "status": "pending",
+      "activeForm": "Fixing medium-priority bugs"
+    }
+  ]
+}
+```
+
+## Validation
+
+- [ ] Generates activeForm for all items
+- [ ] Validates status values
+- [ ] Handles various content formats
+- [ ] Preserves original content
+- [ ] Returns proper TodoWrite structure
+
+## Supporting Files
+
+- `template.json`: TodoWrite format template (see Supporting Files section)

package/.claude/skills/format-todo-list/template.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "TodoWrite Format",
+  "type": "object",
+  "required": ["todos"],
+  "properties": {
+    "todos": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["content", "status", "activeForm"],
+        "properties": {
+          "content": {
+            "type": "string",
+            "description": "Imperative form: 'Run tests', 'Create plan', 'Fix bugs'"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "in_progress", "completed"],
+            "description": "Current status of the todo item"
+          },
+          "activeForm": {
+            "type": "string",
+            "description": "Present continuous form: 'Running tests', 'Creating plan', 'Fixing bugs'"
+          }
+        }
+      }
+    }
+  }
+}

package/.claude/skills/generate-changelog/SKILL.md

@@ -0,0 +1,258 @@
+---
+name: generate-changelog
+description: Generate changelog entries from git commits, plan files, or structured data. Use for version releases, creating CHANGELOG.md sections, or documenting changes between versions.
+allowed-tools: Read, Bash
+---
+
+# Generate Changelog
+
+Automatically generate changelog entries following Keep a Changelog format.
+
+## When to Use
+
+- Version release workflows
+- Creating CHANGELOG.md sections
+- Documenting changes between versions
+- Generating release notes
+- Summarizing work completed
+
+## Instructions
+
+### Step 1: Gather Change Data
+
+Accept change information from various sources.
+
+**Expected Input**:
+- `version`: String (e.g., "0.8.0")
+- `date`: String (ISO-8601 or YYYY-MM-DD)
+- `source`: String (git|plan-file|manual)
+- `sourceData`: Object (git range, plan file path, or manual entries)
+
+**Source Types**:
+- **git**: Parse git log between two refs
+- **plan-file**: Extract from plan file metadata
+- **manual**: User-provided entries
+
+### Step 2: Parse Changes
+
+Extract and categorize changes.
+
+**Categories** (Keep a Changelog standard):
+- **Added**: New features
+- **Changed**: Changes to existing functionality
+- **Deprecated**: Soon-to-be removed features
+- **Removed**: Removed features
+- **Fixed**: Bug fixes
+- **Security**: Security vulnerability fixes
+
+**Git Commit Parsing**:
+- Parse conventional commit format (feat:, fix:, etc.)
+- Extract scope and description
+- Map commit type to changelog category
+
+### Step 3: Group and Deduplicate
+
+Group changes by category and remove duplicates.
+
+**Grouping Rules**:
+- feat → Added
+- fix → Fixed
+- security → Security
+- refactor, perf → Changed
+- docs → Changed (if significant)
+- chore → Omit (unless breaking change)
+
+### Step 4: Format Changelog Section
+
+Create formatted changelog section.
+
+**Format**:
+```markdown
+## [Version] - Date
+
+### Added
+- New feature 1
+- New feature 2
+
+### Fixed
+- Bug fix 1
+- Bug fix 2
+
+### Changed
+- Change 1
+```
+
+### Step 5: Return Formatted Changelog
+
+Return complete changelog section ready for insertion.
+
+**Expected Output**:
+```markdown
+## [0.8.0] - 2025-10-17
+
+### Added
+- Dark mode toggle for user preferences
+- OAuth2 authentication support
+
+### Fixed
+- Memory leak in connection pool
+- CORS configuration error
+
+### Changed
+- Migrated to v2 authentication API
+- Optimized query performance
+```
+
+## Error Handling
+
+- **No Changes Found**: Return empty changelog with note
+- **Invalid Git Range**: Return error with git command output
+- **Invalid Plan File**: Return error describing issue
+- **Unparseable Commits**: Include as "Changed" with raw message
+
+## Examples
+
+### Example 1: Generate from Git Range
+
+**Input**:
+```json
+{
+  "version": "0.8.0",
+  "date": "2025-10-17",
+  "source": "git",
+  "sourceData": {
+    "fromRef": "v0.7.0",
+    "toRef": "HEAD"
+  }
+}
+```
+
+**Git Commits**:
+```
+feat(auth): add OAuth2 support
+fix(api): resolve memory leak
+docs: update API documentation
+chore(deps): bump dependencies
+```
+
+**Output**:
+```markdown
+## [0.8.0] - 2025-10-17
+
+### Added
+- Add OAuth2 support (auth)
+
+### Fixed
+- Resolve memory leak (api)
+
+### Changed
+- Update API documentation
+```
+
+### Example 2: Generate from Plan File
+
+**Input**:
+```json
+{
+  "version": "0.8.0",
+  "date": "2025-10-17",
+  "source": "plan-file",
+  "sourceData": {
+    "planFile": ".version-update-plan.json"
+  }
+}
+```
+
+**Plan File Content**:
+```json
+{
+  "changes": {
+    "added": ["Dark mode toggle", "User profiles"],
+    "fixed": ["Login redirect bug", "Dashboard crash"],
+    "changed": ["Improved performance"]
+  }
+}
+```
+
+**Output**:
+```markdown
+## [0.8.0] - 2025-10-17
+
+### Added
+- Dark mode toggle
+- User profiles
+
+### Fixed
+- Login redirect bug
+- Dashboard crash
+
+### Changed
+- Improved performance
+```
+
+### Example 3: Manual Entries
+
+**Input**:
+```json
+{
+  "version": "0.8.0",
+  "date": "2025-10-17",
+  "source": "manual",
+  "sourceData": {
+    "added": ["New payment gateway integration"],
+    "fixed": ["Cart calculation error"],
+    "security": ["Fixed XSS vulnerability in search"]
+  }
+}
+```
+
+**Output**:
+```markdown
+## [0.8.0] - 2025-10-17
+
+### Added
+- New payment gateway integration
+
+### Fixed
+- Cart calculation error
+
+### Security
+- Fixed XSS vulnerability in search
+```
+
+### Example 4: Empty Changelog
+
+**Input**:
+```json
+{
+  "version": "0.8.0",
+  "date": "2025-10-17",
+  "source": "git",
+  "sourceData": {
+    "fromRef": "v0.7.0",
+    "toRef": "v0.7.0"
+  }
+}
+```
+
+**Output**:
+```markdown
+## [0.8.0] - 2025-10-17
+
+No changes in this release.
+```
+
+## Validation
+
+- [ ] Parses conventional commits correctly
+- [ ] Maps commit types to changelog categories
+- [ ] Groups changes by category
+- [ ] Formats according to Keep a Changelog
+- [ ] Handles empty changelogs
+- [ ] Deduplicates entries
+- [ ] Includes scope in entries when present
+- [ ] Handles manual entries
+
+## Supporting Files
+
+- `commit-mapping.json`: Conventional commit to changelog category mapping

package/.claude/skills/generate-changelog/commit-mapping.json

@@ -0,0 +1,47 @@
+{
+  "feat": {
+    "category": "Added",
+    "description": "New features"
+  },
+  "fix": {
+    "category": "Fixed",
+    "description": "Bug fixes"
+  },
+  "security": {
+    "category": "Security",
+    "description": "Security fixes"
+  },
+  "perf": {
+    "category": "Changed",
+    "description": "Performance improvements"
+  },
+  "refactor": {
+    "category": "Changed",
+    "description": "Code refactoring"
+  },
+  "docs": {
+    "category": "Changed",
+    "description": "Documentation updates",
+    "skipIfMinor": true
+  },
+  "style": {
+    "category": null,
+    "description": "Code style changes",
+    "skip": true
+  },
+  "test": {
+    "category": null,
+    "description": "Test changes",
+    "skip": true
+  },
+  "chore": {
+    "category": null,
+    "description": "Maintenance",
+    "skip": true,
+    "includeIfBreaking": true
+  },
+  "revert": {
+    "category": "Fixed",
+    "description": "Reverted changes"
+  }
+}