Remove escape hatches that allowed the orchestrator to skip parallel
execution for "trivial" tasks. The whole point of ensemble is to get
genuinely independent perspectives via parallel execution.
Changes:
- Replace "appropriateness check" with mandatory 3-agent spawn
- Add "NEVER solve the task yourself" constraint
- Remove "trivial tasks" exception
- Clarify "single message with 3 Task tool calls"
Adds ensemble-orchestrator agent and ensemble-solving skill that:
- Generates 3 diverse solution approaches in parallel
- Uses different strategies: constraint variation (code), approach
variation (architecture), persona variation (creative)
- Evaluates solutions with weighted rubric
- Returns best solution with alternatives summary
Model selection: opus for architecture/design, sonnet for code.
Includes reference materials for diversification strategies and
evaluation rubrics.
Update .claude/settings.json to use the new hook format with matcher-based structure instead of simple strings.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Updated README.md to accurately represent the current state of the repository:
- Added productivity-skills-plugin to repository structure diagram
- Fixed plan-implementer.md file reference (was incorrectly shown as directory)
- Expanded visual-documentation-plugin skills listing (4 skills)
- Added productivity-skills-plugin to Available Plugins section
- Added Productivity & Analysis section with 4 skills:
- conversation-analyzer
- code-auditor
- codebase-documenter
- project-bootstrapper
- Added installation command for productivity-skills-plugin
- Removed references to non-existent files (CHANGELOG.md, CONTRIBUTING.md, SETUP.md)
All sections now accurately match the actual repository contents.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
* improve: enhance skill descriptions for better automatic activation
Improved skill descriptions across both plugins to trigger more reliably
when users make requests without specifying exact keywords or formats.
## Visual Documentation Plugin Skills
All four skills improved to activate regardless of whether users specify HTML:
- **flowchart-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "process flows"
- **dashboard-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "monitoring interfaces"
- **timeline-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "project plans"
- **technical-doc-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "API references", "developer documentation"
## Engineering Workflow Plugin Skills
All four skills enhanced with additional natural language triggers:
- **feature-planning**: Removed "requires planning before implementation" (too restrictive)
Added triggers: "create X feature", "I need X"
- **test-fixing**: Added triggers: "run tests and fix failures", "tests aren't passing"
- **git-pushing**: Added triggers: "push this", "push to github"
- **review-implementing**: Added triggers: "fix review issues", "apply these suggestions"
## Testing Artifacts
Added comprehensive test examples and sample outputs:
- TEST_EXAMPLES.md with detailed test cases for each visual skill
- Sample HTML outputs for flowchart and dashboard skills
## Impact
Skills will now activate more reliably when users make natural requests
without requiring exact phrasing or format specifications. This provides
a better user experience and ensures skills are preferred over Claude's
built-in knowledge.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* feat: add productivity-skills plugin with workflow optimization capabilities
Add new productivity-skills plugin containing 4 skills for analyzing usage patterns,
auditing code quality, bootstrapping projects, and generating documentation:
- conversation-analyzer: Analyzes Claude Code usage patterns and suggests workflow improvements
- Includes Python analysis script for comprehensive conversation history analysis
- Identifies patterns, common mistakes, and automation opportunities
- code-auditor: Comprehensive codebase analysis covering architecture, security, performance
- project-bootstrapper: Sets up projects with best practices, tooling, and documentation
- codebase-documenter: Generates comprehensive documentation for codebases
Also includes:
- CLAUDE.md: Development guidelines for building marketplace plugins and skills
- Updated marketplace.json with productivity-skills plugin
- Analysis scripts and tools bundled with conversation-analyzer skill
- Updated .gitignore to exclude local analysis outputs
Plugin follows marketplace conventions with proper structure (SKILL.md files,
.claude-plugin/plugin.json, README.md, scripts/ and references/ directories).
Based on analysis of 900+ Claude Code conversations to identify common workflow
optimization needs and productivity patterns.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: enforce skills-first approach in CLAUDE.md guidelines
Update development guidelines to make skills usage mandatory rather than optional:
- Elevate "Skills first" to #1 priority in working guidelines
- Create dedicated "Critical Working Guidelines" section
- Add explicit rule: "ALWAYS use skills when available"
- Specify concrete examples (git-pushing, feature-planning, test-fixing)
- Emphasize: never implement manually when a skill exists
This ensures consistent skill usage throughout the marketplace development
and reinforces the skills-based workflow for all contributors.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* feat(git-pushing): add smart_commit.sh script for faster workflow
Add automated script to speed up git-pushing skill execution:
- Auto-stages all changes
- Auto-generates conventional commit messages
- Determines type (feat/fix/docs/test/chore/refactor) from file patterns
- Extracts scope from changed files
- Adds Claude Code footer automatically
- Smart push handling (new vs existing branches)
- Colored output for better UX
- Shows PR link for GitHub repos
Updated SKILL.md with:
- Fast Path (recommended) - uses script for speed
- Manual Path (fallback) - step-by-step commands
Speed improvement: 1 command instead of 5+ separate bash calls.
Script location: engineering-workflow-plugin/skills/git-pushing/scripts/smart_commit.sh
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs(CLAUDE.md): mandate skill-creator usage for new skills
Add critical guideline requiring use of skill-creator skill when creating new skills:
- Added explicit rule: "Use skill-creator for creating new skills"
- Created "CRITICAL: When creating new skills" section
- Emphasized that manual creation leads to missing files and incorrect structure
- References issue where productivity-skills were created manually without proper structure
This prevents future skills from being created with missing skill.json files,
incorrect directory structure, or other structural issues.
Lesson learned: productivity-skills plugin was created manually and lacks
proper skill structure (missing skill.json files in skill directories).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(productivity-skills): correct plugin structure to follow auto-discovery pattern
Fix productivity-skills plugin to follow correct Claude Code plugin structure:
Structural changes:
- Move all skills into skills/ subdirectory (was at plugin root)
- Remove skills array from plugin.json (skills are auto-discovered)
- plugin.json now contains only metadata (name, version, description, author)
Skills moved:
- conversation-analyzer → skills/conversation-analyzer
- code-auditor → skills/code-auditor
- project-bootstrapper → skills/project-bootstrapper
- codebase-documenter → skills/codebase-documenter
CLAUDE.md updates:
- Document that skills MUST be in skills/ subdirectory
- Clarify that skills, agents, and commands are auto-discovered
- Update plugin.json template to show metadata-only structure
- Remove incorrect examples showing skills/agents arrays in plugin.json
This follows the official Claude Code plugin structure where skills are
automatically discovered from the skills/ directory rather than being
listed in plugin.json.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* chore: Restructure of skills, add readme files
---------
Co-authored-by: Claude <noreply@anthropic.com>
* improve: enhance skill descriptions for better automatic activation
Improved skill descriptions across both plugins to trigger more reliably
when users make requests without specifying exact keywords or formats.
## Visual Documentation Plugin Skills
All four skills improved to activate regardless of whether users specify HTML:
- **flowchart-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "process flows"
- **dashboard-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "monitoring interfaces"
- **timeline-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "project plans"
- **technical-doc-creator**: Removed "explicitly" and "in HTML format" restrictions
Added triggers: "API references", "developer documentation"
## Engineering Workflow Plugin Skills
All four skills enhanced with additional natural language triggers:
- **feature-planning**: Removed "requires planning before implementation" (too restrictive)
Added triggers: "create X feature", "I need X"
- **test-fixing**: Added triggers: "run tests and fix failures", "tests aren't passing"
- **git-pushing**: Added triggers: "push this", "push to github"
- **review-implementing**: Added triggers: "fix review issues", "apply these suggestions"
## Testing Artifacts
Added comprehensive test examples and sample outputs:
- TEST_EXAMPLES.md with detailed test cases for each visual skill
- Sample HTML outputs for flowchart and dashboard skills
## Impact
Skills will now activate more reliably when users make natural requests
without requiring exact phrasing or format specifications. This provides
a better user experience and ensures skills are preferred over Claude's
built-in knowledge.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* refactor: replace test outputs with concise EXAMPLES.md
Removed test-outputs directory and TEST_EXAMPLES.md in favor of a cleaner,
more focused EXAMPLES.md that provides:
- Clear example prompts for each skill (simple and detailed)
- Expected output descriptions
- Best practices for getting good results
- Customization tips
- Browser compatibility info
This is more maintainable than actual test HTML files and gives users
better guidance on how to use each skill effectively.
---------
Co-authored-by: Claude <noreply@anthropic.com>
* feat: add visual-documentation-plugin with visual-html-creator skill
Add comprehensive plugin for creating stunning visual HTML documentation
with modern UI design, SVG diagrams, flowcharts, dashboards, and timelines.
## New Plugin: visual-documentation-plugin
### Features
- Visual HTML Creator skill for generating standalone HTML documentation
- 4 visualization types: flowcharts, dashboards, technical docs, timelines
- Complete design system with semantic colors and responsive layouts
- Self-contained HTML output with no external dependencies
- WCAG AA accessibility compliance
### Skill Capabilities
- Process flow diagrams with decision trees and color-coded stages
- Metric dashboards with KPI cards, bar/pie/line charts
- Technical documentation with code blocks and syntax highlighting
- Project timelines with Gantt charts and milestone markers
### Bundled Resources
- 4 HTML template files (56KB): base, flowchart, dashboard, timeline
- 2 comprehensive reference guides (28KB): design patterns, SVG library
- Complete CSS framework with modern gradient theme
- 250+ reusable SVG component patterns
### Documentation
- README.md with usage examples and feature overview
- SETUP.md with installation and configuration guide
- CHANGELOG.md tracking version history
- 2,700+ lines of documentation and templates
### Repository Updates
- Added plugin to marketplace.json manifest
- Updated main README with plugin documentation and examples
- Created MARKETPLACE_STRUCTURE.md for repository overview
## Technical Details
- Plugin version: 1.0.0
- Total files: 11
- Total size: ~100KB
- Supports responsive design (768px breakpoint)
- Browser compatible (Chrome, Firefox, Safari, Edge)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* refactor: split visual-html-creator into 4 focused skills
Split the monolithic visual-html-creator skill into 4 specialized skills
for better activation precision and focused use cases.
## Changes
### New Skills (4)
1. **flowchart-creator** - Process flow diagrams and decision trees
- Activates on: flowcharts, process diagrams, workflows, decision trees
- Examples: order processing, deployment flows, approval workflows
2. **dashboard-creator** - KPI dashboards and data visualizations
- Activates on: dashboards, metrics, KPIs, data charts
- Examples: analytics dashboards, sales metrics, performance tracking
3. **technical-doc-creator** - API docs and system architecture
- Activates on: technical docs, API documentation, architecture diagrams
- Examples: API endpoints, authentication systems, microservices
4. **timeline-creator** - Project timelines and Gantt charts
- Activates on: timelines, roadmaps, Gantt charts, schedules
- Examples: product launches, project roadmaps, sprint schedules
### Shared Resources
- Kept visual-html-creator directory for shared resources (templates, references)
- All 4 skills reference the same design system and component library
- Maintains consistency while enabling focused skill activation
### Documentation Updates
- Updated plugin README with 4 skill descriptions
- Updated marketplace README with individual skill entries
- Updated CHANGELOG to reflect new structure
- Each skill has comprehensive SKILL.md with specific workflow guidance
## Benefits
- **Better activation**: Claude can choose the right skill for specific requests
- **Focused instructions**: Each skill has targeted guidance for its use case
- **Clearer triggers**: More precise activation conditions
- **Maintained consistency**: Shared design system across all skills
## Technical Details
- 4 new SKILL.md files (~3,000 lines each)
- Removed monolithic visual-html-creator SKILL.md
- Preserved shared resources (templates, references)
- Updated all cross-references in documentation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* refactor: distribute visual-html-creator files to four focused skills
Complete file distribution from visual-html-creator to the four new skills:
- flowchart-creator
- dashboard-creator
- timeline-creator
- technical-doc-creator
Changes:
- Distributed shared resources (design_patterns.md, svg_library.md, base_template.html) to all four skills
- Distributed skill-specific component templates to respective skills
- Removed original visual-html-creator directory
Each skill now has complete standalone resources in:
- references/ (design patterns and SVG library)
- assets/templates/ (base template + skill-specific components)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
Add animated GIF demonstrating skill loading workflow to the top of README for better visual introduction to the marketplace.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
- Move plan-implementer AGENT.md to correct location (agents/plan-implementer.md)
- Remove skills and agents arrays from plugin.json as they should be defined in marketplace.json
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
* refactor: restructure to standard plugin format
Reorganize repository to follow Claude Code plugin conventions:
- Move all skills to skills/ directory
- Move plan-implementer to agents/ directory
- Add plugin.json with proper skill/agent references
- Update marketplace.json to simplified format
- Add CHANGELOG.md for version tracking
This aligns with the standard plugin structure where:
- .claude-plugin/plugin.json defines the plugin manifest
- .claude-plugin/marketplace.json lists plugins for distribution
- skills/ contains all skill directories
- agents/ contains all agent definitions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* refactor: organize into marketplace structure
Restructure repository as a proper marketplace containing plugins:
- Move plugin to engineering-workflow-plugin/ subdirectory
- Update marketplace.json to reference plugin source path
- Move all plugin files (skills, agents, docs) into plugin directory
- Update README to reflect marketplace structure
Structure now matches:
marketplace/
├── .claude-plugin/marketplace.json
└── engineering-workflow-plugin/
├── .claude-plugin/plugin.json
├── agents/
├── skills/
└── docs
This enables the marketplace to host multiple plugins in the future.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
Add comprehensive feature development workflow:
- feature-planning skill: breaks down features into implementable tasks
- plan-implementer agent: executes tasks with Haiku model
- Detailed planning best practices reference guide
- Integration with existing test-fixing and git-pushing skills
Updates marketplace to v1.1.0 with complete workflow documentation.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Includes three production-ready skills for software engineering workflows:
- git-pushing: Automated git workflows with conventional commits
- test-fixing: Smart test failure resolution with error grouping
- review-implementing: Systematic code review feedback implementation
Features:
- Comprehensive documentation and contributing guidelines
- Apache 2.0 license for open source distribution
- Installation instructions for Claude Code
- Best practices guide for skill authoring
Skills use natural language activation instead of slash commands,
making them more intuitive and context-aware.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>