heraspec 0.1.12 → 0.1.14

package/dist/core/templates/skills/CHANGELOG.md

@@ -1,117 +1,117 @@
-# UI/UX Skill Changelog
-
-## New Features
-
-### 🔍 Multiple Search Modes
-
-UI/UX Builder now supports 3 search modes for better results:
-
-1. **BM25 (Default)** ⚡
-   - Fast keyword-based search
-   - Zero dependencies
-   - Works out of the box
-   - Best for exact keyword matches
-
-2. **Vector Mode** 🧠
-   - Semantic search using sentence transformers
-   - Understands meaning and synonyms
-   - ~15-20% better results than BM25
-   - Requires: `pip install sentence-transformers scikit-learn`
-
-3. **Hybrid Mode** 🎯
-   - Combines BM25 + Vector search
-   - Best overall results (~25% improvement)
-   - Catches both exact and semantic matches
-   - Requires: `pip install sentence-transformers scikit-learn`
-
-**Usage:**
-```bash
-# BM25 (default)
-python3 scripts/search.py "minimalism" --domain style
-
-# Vector (semantic)
-python3 scripts/search.py "elegant dark theme" --domain style --mode vector
-
-# Hybrid (best)
-python3 scripts/search.py "modern minimal design" --domain style --mode hybrid
-```
-
-### 📄 Multi-Page Website Support
-
-Added support for creating complete website packages with 9 default page types:
-
-1. Home
-2. About
-3. Post Details
-4. Category
-5. Pricing
-6. FAQ
-7. Contact
-8. Product Category (e-commerce)
-9. Product Details (e-commerce)
-
-**New Domain:** `pages` - Search for page type templates
-
-**Usage:**
-```bash
-python3 scripts/search.py "home homepage" --domain pages
-python3 scripts/search.py "pricing plans" --domain pages
-```
-
-### 📚 Enhanced Documentation
-
-- Added `SEARCH_MODES_GUIDE.md` - Detailed guide on search modes
-- Added `SEARCH_ALGORITHMS_COMPARISON.md` - Algorithm comparison
-- Added `CODE_EXPLANATION.md` - How the search engine works
-- Updated `ui-ux-skill.md` with search mode examples
-- Added references to base [UI UX Pro Max Skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) project that UI/UX Builder is built upon
-
-## Improvements
-
-- Auto-fallback to BM25 if Vector/Hybrid dependencies not installed
-- Better error messages and warnings
-- Mode information in search results output
-- Updated all examples with search mode options
-
-## Migration Guide
-
-### For Existing Users
-
-No changes required! BM25 remains the default mode.
-
-### To Use New Features
-
-1. **For Vector/Hybrid modes:**
-   ```bash
-   pip install sentence-transformers scikit-learn
-   ```
-
-2. **Update your search commands:**
-   ```bash
-   # Old (still works)
-   python3 scripts/search.py "query" --domain style
-   
-   # New (better results)
-   python3 scripts/search.py "query" --domain style --mode hybrid
-   ```
-
-3. **For multi-page websites:**
-   ```bash
-   # Search page types
-   python3 scripts/search.py "home" --domain pages
-   ```
-
-## Performance
-
-| Mode | Speed | Accuracy | Dependencies |
-|------|-------|----------|--------------|
-| BM25 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | None |
-| Vector | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | sentence-transformers |
-| Hybrid | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | sentence-transformers |
-
-## Backward Compatibility
-
-✅ All existing commands work without changes
-✅ BM25 remains default mode
-✅ Auto-fallback if dependencies missing
-✅ No breaking changes
+# UI/UX Skill Changelog
+
+## New Features
+
+### 🔍 Multiple Search Modes
+
+UI/UX Builder now supports 3 search modes for better results:
+
+1. **BM25 (Default)** ⚡
+   - Fast keyword-based search
+   - Zero dependencies
+   - Works out of the box
+   - Best for exact keyword matches
+
+2. **Vector Mode** 🧠
+   - Semantic search using sentence transformers
+   - Understands meaning and synonyms
+   - ~15-20% better results than BM25
+   - Requires: `pip install sentence-transformers scikit-learn`
+
+3. **Hybrid Mode** 🎯
+   - Combines BM25 + Vector search
+   - Best overall results (~25% improvement)
+   - Catches both exact and semantic matches
+   - Requires: `pip install sentence-transformers scikit-learn`
+
+**Usage:**
+```bash
+# BM25 (default)
+python3 scripts/search.py "minimalism" --domain style
+
+# Vector (semantic)
+python3 scripts/search.py "elegant dark theme" --domain style --mode vector
+
+# Hybrid (best)
+python3 scripts/search.py "modern minimal design" --domain style --mode hybrid
+```
+
+### 📄 Multi-Page Website Support
+
+Added support for creating complete website packages with 9 default page types:
+
+1. Home
+2. About
+3. Post Details
+4. Category
+5. Pricing
+6. FAQ
+7. Contact
+8. Product Category (e-commerce)
+9. Product Details (e-commerce)
+
+**New Domain:** `pages` - Search for page type templates
+
+**Usage:**
+```bash
+python3 scripts/search.py "home homepage" --domain pages
+python3 scripts/search.py "pricing plans" --domain pages
+```
+
+### 📚 Enhanced Documentation
+
+- Added `SEARCH_MODES_GUIDE.md` - Detailed guide on search modes
+- Added `SEARCH_ALGORITHMS_COMPARISON.md` - Algorithm comparison
+- Added `CODE_EXPLANATION.md` - How the search engine works
+- Updated `ui-ux-skill.md` with search mode examples
+- Added references to base [UI UX Pro Max Skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) project that UI/UX Builder is built upon
+
+## Improvements
+
+- Auto-fallback to BM25 if Vector/Hybrid dependencies not installed
+- Better error messages and warnings
+- Mode information in search results output
+- Updated all examples with search mode options
+
+## Migration Guide
+
+### For Existing Users
+
+No changes required! BM25 remains the default mode.
+
+### To Use New Features
+
+1. **For Vector/Hybrid modes:**
+   ```bash
+   pip install sentence-transformers scikit-learn
+   ```
+
+2. **Update your search commands:**
+   ```bash
+   # Old (still works)
+   python3 scripts/search.py "query" --domain style
+   
+   # New (better results)
+   python3 scripts/search.py "query" --domain style --mode hybrid
+   ```
+
+3. **For multi-page websites:**
+   ```bash
+   # Search page types
+   python3 scripts/search.py "home" --domain pages
+   ```
+
+## Performance
+
+| Mode | Speed | Accuracy | Dependencies |
+|------|-------|----------|--------------|
+| BM25 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | None |
+| Vector | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | sentence-transformers |
+| Hybrid | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | sentence-transformers |
+
+## Backward Compatibility
+
+✅ All existing commands work without changes
+✅ BM25 remains default mode
+✅ Auto-fallback if dependencies missing
+✅ No breaking changes

package/dist/core/templates/skills/README-template.md

@@ -1,58 +1,58 @@
-# Skills Directory
-
-This directory contains reusable skills for HeraSpec projects.
-
-## What Are Skills?
-
-Skills are reusable patterns and workflows that help AI agents implement tasks consistently. Each skill contains:
-
-- **skill.md**: Complete guide on how to use the skill
-- **templates/**: Reusable templates
-- **scripts/**: Automation scripts
-- **examples/**: Good and bad examples
-
-## Skill Structure
-
-```
-skills/
-├── <project-type>/          # Project-specific skills
-│   └── <skill-name>/
-│       ├── skill.md
-│       ├── templates/
-│       ├── scripts/
-│       └── examples/
-│
-└── <skill-name>/            # Cross-cutting skills
-    ├── skill.md
-    ├── templates/
-    ├── scripts/
-    └── examples/
-```
-
-## How Agents Use Skills
-
-When a task has a skill tag:
-\`\`\`markdown
-## 1. Feature (projectType: perfex-module, skill: module-codebase)
-- [ ] Task 1.1
-\`\`\`
-
-The agent will:
-1. Find skill folder: \`heraspec/skills/perfex-module/module-codebase/\`
-2. Read \`skill.md\` to understand process
-3. Use templates and scripts from skill folder
-4. Follow guidelines in skill.md
-
-## Available Skills
-
-Run \`heraspec skill list\` to see all available skills.
-
-## Creating New Skills
-
-1. Create skill folder structure
-2. Write \`skill.md\` following the template
-3. Add templates, scripts, examples as needed
-4. Update this README
-
-See \`docs/SKILLS_STRUCTURE_PROPOSAL.md\` for detailed structure.
-
+# Skills Directory
+
+This directory contains reusable skills for HeraSpec projects.
+
+## What Are Skills?
+
+Skills are reusable patterns and workflows that help AI agents implement tasks consistently. Each skill contains:
+
+- **skill.md**: Complete guide on how to use the skill
+- **templates/**: Reusable templates
+- **scripts/**: Automation scripts
+- **examples/**: Good and bad examples
+
+## Skill Structure
+
+```
+skills/
+├── <project-type>/          # Project-specific skills
+│   └── <skill-name>/
+│       ├── skill.md
+│       ├── templates/
+│       ├── scripts/
+│       └── examples/
+│
+└── <skill-name>/            # Cross-cutting skills
+    ├── skill.md
+    ├── templates/
+    ├── scripts/
+    └── examples/
+```
+
+## How Agents Use Skills
+
+When a task has a skill tag:
+\`\`\`markdown
+## 1. Feature (projectType: perfex-module, skill: module-codebase)
+- [ ] Task 1.1
+\`\`\`
+
+The agent will:
+1. Find skill folder: \`heraspec/skills/perfex-module/module-codebase/\`
+2. Read \`skill.md\` to understand process
+3. Use templates and scripts from skill folder
+4. Follow guidelines in skill.md
+
+## Available Skills
+
+Run \`heraspec skill list\` to see all available skills.
+
+## Creating New Skills
+
+1. Create skill folder structure
+2. Write \`skill.md\` following the template
+3. Add templates, scripts, examples as needed
+4. Update this README
+
+See \`docs/SKILLS_STRUCTURE_PROPOSAL.md\` for detailed structure.
+

package/dist/core/templates/skills/README.md

@@ -1,38 +1,38 @@
-# Skills Templates
-
-This directory contains skill.md templates and resources for HeraSpec skills.
-
-## Available Skills
-
-- `module-codebase-skill.md` - For Perfex module codebase structure
-- `ui-ux-skill.md` - For UI/UX design and styling (with UI/UX Builder integration)
-- `documents-skill.md` - For technical and user documentation
-- `content-optimization-skill.md` - For content and CTA optimization
-- `wordpress-plugin-check-skill.md` - Run WordPress Plugin Check and fix issues
-- `plugin-directory-skill.md` - **NEW** Review plugin against 18 WordPress.org Directory Guidelines
-
-## UI/UX Skill Resources
-
-The `ui-ux-skill.md` includes integration with UI/UX Builder (built upon [UI UX Pro Max Skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)):
-
-- **Scripts**: `scripts/search.py` and `scripts/core.py` for searching design database
-- **Search Modes**: 
-  - **BM25** (default) - Fast keyword-based search, zero dependencies
-  - **Vector** - Semantic search with ~15-20% better results (requires: `pip install sentence-transformers scikit-learn`)
-  - **Hybrid** - Best of both worlds with ~25% better results (requires: `pip install sentence-transformers scikit-learn`)
-- **Data**: `data/` folder contains CSV databases for:
-  - Styles (57 UI styles)
-  - Colors (95 color palettes)
-  - Typography (56 font pairings)
-  - Charts (24 chart types)
-  - Products (product recommendations)
-  - Pages (9+ page types for multi-page websites)
-  - Landing pages (page structures)
-  - UX guidelines (98 best practices)
-  - Stacks (8 tech stack guidelines)
-
-## Usage
-
-When creating a new skill, copy the appropriate template and customize it for your specific skill.
-
-For UI/UX tasks, agents will automatically use the search scripts to find relevant design intelligence before implementing.
+# Skills Templates
+
+This directory contains skill.md templates and resources for HeraSpec skills.
+
+## Available Skills
+
+- `module-codebase-skill.md` - For Perfex module codebase structure
+- `ui-ux-skill.md` - For UI/UX design and styling (with UI/UX Builder integration)
+- `documents-skill.md` - For technical and user documentation
+- `content-optimization-skill.md` - For content and CTA optimization
+- `wordpress-plugin-check-skill.md` - Run WordPress Plugin Check and fix issues
+- `plugin-directory-skill.md` - **NEW** Review plugin against 18 WordPress.org Directory Guidelines
+
+## UI/UX Skill Resources
+
+The `ui-ux-skill.md` includes integration with UI/UX Builder (built upon [UI UX Pro Max Skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)):
+
+- **Scripts**: `scripts/search.py` and `scripts/core.py` for searching design database
+- **Search Modes**: 
+  - **BM25** (default) - Fast keyword-based search, zero dependencies
+  - **Vector** - Semantic search with ~15-20% better results (requires: `pip install sentence-transformers scikit-learn`)
+  - **Hybrid** - Best of both worlds with ~25% better results (requires: `pip install sentence-transformers scikit-learn`)
+- **Data**: `data/` folder contains CSV databases for:
+  - Styles (57 UI styles)
+  - Colors (95 color palettes)
+  - Typography (56 font pairings)
+  - Charts (24 chart types)
+  - Products (product recommendations)
+  - Pages (9+ page types for multi-page websites)
+  - Landing pages (page structures)
+  - UX guidelines (98 best practices)
+  - Stacks (8 tech stack guidelines)
+
+## Usage
+
+When creating a new skill, copy the appropriate template and customize it for your specific skill.
+
+For UI/UX tasks, agents will automatically use the search scripts to find relevant design intelligence before implementing.

package/dist/core/templates/skills/content-optimization-skill.md

@@ -1,104 +1,104 @@
-# Skill: Content Optimization (Cross-Cutting)
-
-## Purpose
-
-This skill is used to optimize content and increase CTA (Call-to-Action) conversion for the product/module being developed. Focus on conversion optimization and user engagement.
-
-## When to Use
-
-- When creating landing pages
-- When designing CTA buttons
-- When writing marketing content
-- When optimizing email campaigns
-- When needing to increase conversion rates
-
-## Step-by-Step Process
-
-### Step 1: Analyze Goals
-- Identify conversion goal (signup, purchase, download, etc.)
-- Identify target audience
-- Identify value proposition
-- Research competitors
-
-### Step 2: Create Content Variants
-- Use template: `templates/cta-template.md`
-- Use template: `templates/landing-page-template.md`
-- Create multiple variants for A/B testing
-- Run script: `scripts/generate-ab-test-variants.sh`
-
-### Step 3: Optimize CTA Placement
-- Above the fold for primary CTA
-- Multiple CTAs for long pages
-- Exit-intent CTAs
-- Follow good examples in `examples/high-conversion-cta/`
-
-### Step 4: Test & Measure
-- Setup A/B testing
-- Run script: `scripts/analyze-cta-performance.py`
-- Measure conversion rates
-- Track user behavior
-
-### Step 5: Iterate
-- Analyze results
-- Optimize based on data
-- Test new variants
-- Continuously improve
-
-## Required Input
-
-- **Conversion goal**: Signup, purchase, download, etc.
-- **Target audience**: Demographics, interests, pain points
-- **Value proposition**: Unique selling points
-- **Current conversion rate**: Baseline for comparison
-- **Content type**: Landing page, email, banner, etc.
-
-## Expected Output
-
-- Optimized content with clear CTAs
-- Multiple variants for A/B testing
-- Performance metrics and analysis
-- Recommendations for improvement
-
-## Tone & Rules
-
-### Content Principles
-- **Clear value**: Clear value proposition
-- **Urgency**: Create sense of urgency (if appropriate)
-- **Benefit-focused**: Focus on benefits, not just features
-- **Action-oriented**: Language that stimulates action
-
-### CTA Best Practices
-- Action verbs: "Get Started", "Download Now", "Try Free"
-- Clear and specific
-- Visually prominent
-- Above the fold
-- Mobile-friendly
-
-### Limitations
-- ❌ DO NOT use misleading claims
-- ❌ DO NOT create too many CTAs (confusion)
-- ❌ DO NOT ignore mobile experience
-- ❌ DO NOT skip loading speed
-- ❌ DO NOT test without measuring
-
-## Available Templates
-
-- `templates/cta-template.md` - CTA template
-- `templates/landing-page-template.md` - Landing page template
-- `templates/email-campaign-template.md` - Email marketing template
-
-## Available Scripts
-
-- `scripts/analyze-cta-performance.py` - Analyze CTA performance
-- `scripts/generate-ab-test-variants.sh` - Generate variants for A/B testing
-
-## Examples
-
-See `examples/` directory for reference:
-- `high-conversion-cta/` - Effective CTA (high conversion)
-- `low-conversion-cta/` - CTA that needs improvement (low conversion)
-
-## Links to Other Skills
-
-- **ui-ux**: Use to style CTAs and optimize visual hierarchy
-- **documents**: Use to document conversion strategies
+# Skill: Content Optimization (Cross-Cutting)
+
+## Purpose
+
+This skill is used to optimize content and increase CTA (Call-to-Action) conversion for the product/module being developed. Focus on conversion optimization and user engagement.
+
+## When to Use
+
+- When creating landing pages
+- When designing CTA buttons
+- When writing marketing content
+- When optimizing email campaigns
+- When needing to increase conversion rates
+
+## Step-by-Step Process
+
+### Step 1: Analyze Goals
+- Identify conversion goal (signup, purchase, download, etc.)
+- Identify target audience
+- Identify value proposition
+- Research competitors
+
+### Step 2: Create Content Variants
+- Use template: `templates/cta-template.md`
+- Use template: `templates/landing-page-template.md`
+- Create multiple variants for A/B testing
+- Run script: `scripts/generate-ab-test-variants.sh`
+
+### Step 3: Optimize CTA Placement
+- Above the fold for primary CTA
+- Multiple CTAs for long pages
+- Exit-intent CTAs
+- Follow good examples in `examples/high-conversion-cta/`
+
+### Step 4: Test & Measure
+- Setup A/B testing
+- Run script: `scripts/analyze-cta-performance.py`
+- Measure conversion rates
+- Track user behavior
+
+### Step 5: Iterate
+- Analyze results
+- Optimize based on data
+- Test new variants
+- Continuously improve
+
+## Required Input
+
+- **Conversion goal**: Signup, purchase, download, etc.
+- **Target audience**: Demographics, interests, pain points
+- **Value proposition**: Unique selling points
+- **Current conversion rate**: Baseline for comparison
+- **Content type**: Landing page, email, banner, etc.
+
+## Expected Output
+
+- Optimized content with clear CTAs
+- Multiple variants for A/B testing
+- Performance metrics and analysis
+- Recommendations for improvement
+
+## Tone & Rules
+
+### Content Principles
+- **Clear value**: Clear value proposition
+- **Urgency**: Create sense of urgency (if appropriate)
+- **Benefit-focused**: Focus on benefits, not just features
+- **Action-oriented**: Language that stimulates action
+
+### CTA Best Practices
+- Action verbs: "Get Started", "Download Now", "Try Free"
+- Clear and specific
+- Visually prominent
+- Above the fold
+- Mobile-friendly
+
+### Limitations
+- ❌ DO NOT use misleading claims
+- ❌ DO NOT create too many CTAs (confusion)
+- ❌ DO NOT ignore mobile experience
+- ❌ DO NOT skip loading speed
+- ❌ DO NOT test without measuring
+
+## Available Templates
+
+- `templates/cta-template.md` - CTA template
+- `templates/landing-page-template.md` - Landing page template
+- `templates/email-campaign-template.md` - Email marketing template
+
+## Available Scripts
+
+- `scripts/analyze-cta-performance.py` - Analyze CTA performance
+- `scripts/generate-ab-test-variants.sh` - Generate variants for A/B testing
+
+## Examples
+
+See `examples/` directory for reference:
+- `high-conversion-cta/` - Effective CTA (high conversion)
+- `low-conversion-cta/` - CTA that needs improvement (low conversion)
+
+## Links to Other Skills
+
+- **ui-ux**: Use to style CTAs and optimize visual hierarchy
+- **documents**: Use to document conversion strategies