@agentskillkit/agent-skills 1.0.1 → 3.2.1

package/.agent/workflows/pulse.md

@@ -1,4 +1,4 @@
----
+---
 description: Project health dashboard. Agent status, file stats, and real-time progress tracking.
 ---
 
@@ -14,75 +14,143 @@ Display real-time project status including agent progress, file statistics, and
 
 ---
 
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Status Collection** | `orchestrator` | Aggregate status from all running agents |
+| **Health Analysis** | `assessor` | Evaluate project health risks |
+| **Trend Learning** | `learner` | Track observability over time for trend analysis |
+
+---
+
 ## What It Shows
 
-| Section | Information |
-|---------|-------------|
-| **Project Info** | Name, path, tech stack, features |
-| **Agent Board** | Running agents, completed tasks, pending work |
-| **File Stats** | Created/modified file counts |
-| **Preview** | Server URL, health status |
+| Section          | Information                                   |
+| ---------------- | --------------------------------------------- |
+| **Project Info** | Name, path, tech stack, features              |
+| **Agent Board**  | Running agents, completed tasks, pending work |
+| **File Stats**   | Created/modified file counts                  |
+| **Preview**      | Server URL, health status                     |
 
 ---
 
 ## Technical
 
 ### Get Status
+
 // turbo
+
 ```bash
-python .agent/scripts/session_manager.py status
+node .agent/scripts-js/session_manager.js status
+# OR: npm run session:status
 ```
 
 ### Check Preview
+
 // turbo
+
 ```bash
-python .agent/scripts/auto_preview.py status
+node .agent/scripts-js/auto_preview.js status
+# OR: npm run preview:status
 ```
 
 ---
 
+## 📊 observability DASHBOARD (FAANG+)
+
+### Collect observability
+
+// turbo
+
+```bash
+node .agent/scripts-js/observability-collector.js collect
+```
+
+### Show Current observability
+
+// turbo
+
+```bash
+node .agent/scripts-js/observability-collector.js show
+```
+
+### Show 7-Day Trends
+
+// turbo
+
+```bash
+node .agent/scripts-js/observability-collector.js trends
+```
+
+### Dashboard Output
+
+```
+┌─────────────────────────────────────────┐
+│  📊 Project observability Dashboard           │
+├─────────────────────────────────────────┤
+│  Build Time:    2.3s (↓ 15%)           │
+│  Bundle Size:   245KB (stable)          │
+│  Source Files:  142                     │
+│  Test Coverage: 87% (↑ 3%)             │
+│  Lighthouse:    92/100                  │
+│  Security:      0 vulnerabilities       │
+├─────────────────────────────────────────┤
+│  7-Day Trend: ▁▂▃▄▅▆▇█                  │
+└─────────────────────────────────────────┘
+```
+
+### KPI Thresholds
+
+| Metric        | Good    | Warning   | Critical |
+| ------------- | ------- | --------- | -------- |
+| Build Time    | < 5s    | 5-15s     | > 15s    |
+| Bundle Size   | < 250KB | 250-500KB | > 500KB  |
+| Test Coverage | > 80%   | 60-80%    | < 60%    |
+| Lighthouse    | > 90    | 70-90     | < 70     |
+
 ## Example Output
 
 ```markdown
 === Project Status ===
 
-📁 Project: my-ecommerce
-📂 Path: C:/projects/my-ecommerce
-🏷️ Type: nextjs-ecommerce
-📊 Status: active
+📁 Project: my-ecommerce
+📂 Path: C:/projects/my-ecommerce
+🏷️ Type: nextjs-ecommerce
+📊 Status: active
 
-🔧 Tech Stack:
-   Framework: next.js
-   Database: postgresql
-   Auth: clerk
-   Payment: stripe
+🔧 Tech Stack:
+Framework: next.js
+Database: postgresql
+Auth: clerk
+Payment: stripe
 
-✅ Features (5):
-   • product-listing
-   • cart
-   • checkout
-   • user-auth
-   • order-history
+✅ Features (5):
+• product-listing
+• cart
+• checkout
+• user-auth
+• order-history
 
-⏳ Pending (2):
-   • admin-panel
-   • email-notifications
+⏳ Pending (2):
+• admin-panel
+• email-notifications
 
-📄 Files: 73 created, 12 modified
+📄 Files: 73 created, 12 modified
 
 === Agent Status ===
 
-| Agent | Task | Status |
-|-------|------|--------|
-| database-architect | Schema | ✅ Complete |
-| backend-specialist | API | ✅ Complete |
-| frontend-specialist | UI | 🔄 60% |
-| test-engineer | Tests | ⏳ Waiting |
+| Agent               | Task   | Status      |
+| ------------------- | ------ | ----------- |
+| database-architect  | Schema | ✅ Complete |
+| backend-specialist  | API    | ✅ Complete |
+| frontend-specialist | UI     | 🔄 60%      |
+| test-engineer       | Tests  | ⏳ Waiting  |
 
 === Preview ===
 
-🌐 URL: http://localhost:3000
-💚 Health: OK
+🌐 URL: http://localhost:3000
+💚 Health: OK
 ```
 
 ---
@@ -95,21 +163,23 @@ python .agent/scripts/auto_preview.py status
 
 ---
 
-## 🔗 Workflow Chain
+## 🔗 Workflow Chain
 
 ```mermaid
 graph LR
-    A["/pulse"] --> B["📊 Status"]
+    A["/pulse"] --> B["📊 Status"]
     style A fill:#22c55e
 ```
 
-| After /pulse | Run | Purpose |
-|--------------|-----|---------|
-| See issues | `/diagnose` | Debug |
-| Ready to test | `/validate` | Run tests |
-| Ready to deploy | `/launch` | Deploy |
+| After /pulse    | Run         | Purpose   |
+| --------------- | ----------- | --------- |
+| See issues      | `/diagnose` | Debug     |
+| Ready to test   | `/validate` | Run tests |
+| Ready to deploy | `/launch`   | Deploy    |
 
 **Handoff:**
+
 ```markdown
 Status: 5 features complete, preview running at localhost:3000
 ```
+

package/.agent/workflows/stage.md

@@ -14,6 +14,16 @@ Manage preview servers for local development. **Health monitoring and port confl
 
 ---
 
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Pre-Start** | `recovery` | Save current server state |
+| **Port Conflict** | `assessor` | Evaluate best port resolution |
+| **On Failure** | `recovery` | Restore previous server state |
+
+---
+
 ## Sub-commands
 
 ```
@@ -29,21 +39,33 @@ Manage preview servers for local development. **Health monitoring and port confl
 ## Workflow
 
 ### Start Server
+
+@auto @safe
 // turbo
+
 ```bash
-python .agent/scripts/auto_preview.py start
+node .agent/scripts-js/auto_preview.js start
+# OR: npm run preview:start
 ```
 
 ### Stop Server
+
+@auto @safe
 // turbo
+
 ```bash
-python .agent/scripts/auto_preview.py stop
+node .agent/scripts-js/auto_preview.js stop
+# OR: npm run preview:stop
 ```
 
 ### Check Status
+
+@auto @safe
 // turbo
+
 ```bash
-python .agent/scripts/auto_preview.py status
+node .agent/scripts-js/auto_preview.js status
+# OR: npm run preview:status
 ```
 
 ---
@@ -51,16 +73,18 @@ python .agent/scripts/auto_preview.py status
 ## Output Examples
 
 ### Start Success
+
 ```markdown
 🚀 Starting preview...
-   Port: 3000
-   Type: Next.js
+Port: 3000
+Type: Next.js
 
 ✅ Preview ready!
-   URL: http://localhost:3000
+URL: http://localhost:3000
 ```
 
 ### Status Check
+
 ```markdown
 === Preview Status ===
 
@@ -71,10 +95,12 @@ python .agent/scripts/auto_preview.py status
 ```
 
 ### Port Conflict
+
 ```markdown
 ⚠️ Port 3000 is in use.
 
 Options:
+
 1. Start on port 3001
 2. Close app on 3000
 3. Specify different port
@@ -106,12 +132,13 @@ graph LR
     style B fill:#eab308
 ```
 
-| After /stage | Run | Purpose |
-|--------------|-----|---------|
-| Preview running | `/validate` | Test app |
-| Ready to deploy | `/launch` | Production |
+| After /stage    | Run         | Purpose    |
+| --------------- | ----------- | ---------- |
+| Preview running | `/validate` | Test app   |
+| Ready to deploy | `/launch`   | Production |
 
 **Handoff to /validate:**
+
 ```markdown
 Preview running at localhost:3000. Run /validate to test.
 ```

package/.agent/workflows/studio.md

@@ -10,6 +10,28 @@ description: AI-powered design intelligence with 50+ styles, 95+ color palettes,
 
 Comprehensive design guide for web and mobile applications. Contains 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 9 technology stacks. Searchable database with priority-based recommendations.
 
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Design Planning** | `learner` | Analyze past successful design patterns |
+| **Style Selection** | `critic` | Arbitrate conflicting design choices |
+| **Post-Design** | `learner` | Log design decisions for future reference |
+| **Accessibility** | `assessor` | Evaluate accessibility and UX risks |
+
+```
+Flow:
+learner.analyze(past_designs) → recommendations
+       ↓
+style conflict? → critic.arbitrate(style_a vs style_b)
+       ↓
+design complete → assessor.evaluate(accessibility)
+       ↓
+pass → learner.log(design_patterns)
+```
+
+---
+
 ## Prerequisites
 
 Check if Python is installed:
@@ -54,7 +76,7 @@ Extract key information from user request:
 **Always start with `--design-system`** to get comprehensive recommendations with reasoning:
 
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
+node .agent/skills/studio/scripts-js/search.js "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
 ```
 
 This command:
@@ -65,7 +87,7 @@ This command:
 
 **Example:**
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
+node .agent/skills/studio/scripts-js/search.js "beauty spa wellness service" --design-system -p "Serenity Spa"
 ```
 
 ### Step 2b: Persist Design System (Master + Overrides Pattern)
@@ -73,7 +95,7 @@ python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "beauty spa wellness serv
 To save the design system for hierarchical retrieval across sessions, add `--persist`:
 
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"
+node .agent/skills/studio/scripts-js/search.js "<query>" --design-system --persist -p "Project Name"
 ```
 
 This creates:
@@ -82,7 +104,7 @@ This creates:
 
 **With page-specific override:**
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"
+node .agent/skills/studio/scripts-js/search.js "<query>" --design-system --persist -p "Project Name" --page "dashboard"
 ```
 
 This also creates:
@@ -98,7 +120,7 @@ This also creates:
 After getting the design system, use domain searches to get additional details:
 
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
+node .agent/skills/studio/scripts-js/search.js "<keyword>" --domain <domain> [-n <max_results>]
 ```
 
 **When to use detailed searches:**
@@ -116,7 +138,7 @@ python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <dom
 Get implementation-specific best practices. If user doesn't specify a stack, **default to `html-tailwind`**.
 
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
+node .agent/skills/studio/scripts-js/search.js "<keyword>" --stack html-tailwind
 ```
 
 Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`
@@ -170,7 +192,7 @@ Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`
 ### Step 2: Generate Design System (REQUIRED)
 
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
+node .agent/skills/studio/scripts-js/search.js "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
 ```
 
 **Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
@@ -179,16 +201,16 @@ python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "beauty spa wellness serv
 
 ```bash
 # Get UX guidelines for animation and accessibility
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
+node .agent/skills/studio/scripts-js/search.js "animation accessibility" --domain ux
 
 # Get alternative typography options if needed
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
+node .agent/skills/studio/scripts-js/search.js "elegant luxury serif" --domain typography
 ```
 
 ### Step 4: Stack Guidelines
 
 ```bash
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
+node .agent/skills/studio/scripts-js/search.js "layout responsive form" --stack html-tailwind
 ```
 
 **Then:** Synthesize design system + detailed searches and implement the design.
@@ -201,10 +223,10 @@ The `--design-system` flag supports two output formats:
 
 ```bash
 # ASCII box (default) - best for terminal display
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
+node .agent/skills/studio/scripts-js/search.js "fintech crypto" --design-system
 
 # Markdown - best for documentation
-python3 .agent/.shared/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
+node .agent/skills/studio/scripts-js/search.js "fintech crypto" --design-system -f markdown
 ```
 
 ---
@@ -316,4 +338,4 @@ graph LR
 **Handoff to /build:**
 ```markdown
 Design complete. Run /build to implement the UI.
-```
+```

package/.agent/workflows/think.md

@@ -14,6 +14,25 @@ Activate structured ideation mode for architecture decisions, feature planning,
 
 ---
 
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Decision Conflict** | `critic` | Arbitrate when options are too close |
+| **Risk Assessment** | `assessor` | Evaluate risk of each option |
+| **Pattern Learning** | `learner` | Learn from past decisions |
+
+```
+Flow:
+generate options → assessor.evaluate(each)
+       ↓
+scores too close? → critic.arbitrate()
+       ↓
+decision made → learner.log(decision, context)
+```
+
+---
+
 ## 🔴 MANDATORY: Decision Framework
 
 When `/think` is triggered:

package/.agent/workflows/validate.md

@@ -1,5 +1,5 @@
 ---
-description: Test automation suite. Generate, execute, and analyze test coverage with AAA pattern.
+description: Test automation with Vitest/Playwright. Generate, execute, and analyze coverage with AAA pattern.
 ---
 
 # /validate - Test Automation Suite
@@ -14,6 +14,26 @@ Generate comprehensive tests, execute test suites, and analyze coverage. **Follo
 
 ---
 
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Test Generation** | `learner` | Analyze existing test patterns for consistency |
+| **Pre-Test** | `recovery` | Save test state before execution |
+| **Post-Test** | `learner` | Log common failure patterns |
+| **On Failure** | `assessor` | Evaluate test failure severity |
+
+```
+Flow:
+learner.analyze(existing_tests) → generate tests
+       ↓
+recovery.save() → run tests
+       ↓
+failures? → assessor.evaluate(severity) → learner.log(patterns)
+```
+
+---
+
 ## Sub-commands
 
 ```