@agentskillkit/agent-skills 1.0.1 → 3.2.1

package/.agent/config/metrics-config.json

@@ -0,0 +1,109 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "Agent Metrics Configuration",
+    "version": "1.0.0",
+    "description": "Configuration for mandatory metrics collection during autopilot execution",
+    "metrics": {
+        "time_to_completion": {
+            "type": "duration",
+            "unit": "seconds",
+            "target": "minimize",
+            "required": true
+        },
+        "skill_reuse_rate": {
+            "type": "percentage",
+            "target": ">50%",
+            "formula": "skills_reused / skills_invoked",
+            "required": true
+        },
+        "human_intervention_count": {
+            "type": "counter",
+            "target": 0,
+            "description": "Number of notify_user calls during autopilot",
+            "required": true
+        },
+        "error_retry_rate": {
+            "type": "percentage",
+            "target": "<10%",
+            "formula": "retries / total_operations",
+            "required": true
+        },
+        "agent_handoff_count": {
+            "type": "counter",
+            "target": "minimize",
+            "description": "Number of agent switches",
+            "required": true
+        },
+        "first_time_success_rate": {
+            "type": "percentage",
+            "target": ">85%",
+            "formula": "success_no_retry / total_executions",
+            "required": true
+        },
+        "auto_fix_rate": {
+            "type": "percentage",
+            "target": ">85%",
+            "formula": "auto_fixed / total_problems",
+            "required": true
+        },
+        "plan_adherence": {
+            "type": "percentage",
+            "target": "100%",
+            "formula": "deliverables_complete / deliverables_planned",
+            "required": true
+        },
+        "checkpoint_usage": {
+            "type": "counter",
+            "target": ">=1 for risky operations",
+            "required": true
+        },
+        "rollback_count": {
+            "type": "counter",
+            "target": 0,
+            "required": true
+        },
+        "total_phases_completed": {
+            "type": "counter",
+            "description": "Phases completed out of planned",
+            "required": true
+        }
+    },
+    "storage": {
+        "location": ".agent/metrics/",
+        "format": "json",
+        "retention_days": 30,
+        "aggregation": [
+            "daily",
+            "weekly",
+            "monthly"
+        ]
+    },
+    "improvement": {
+        "baseline_window": 10,
+        "alert_threshold_degradation": 0.10,
+        "celebrate_threshold_improvement": 0.20
+    },
+    "recording_triggers": {
+        "execution_start": [
+            "timestamp",
+            "context"
+        ],
+        "phase_complete": [
+            "duration",
+            "status"
+        ],
+        "agent_switch": [
+            "from_agent",
+            "to_agent",
+            "reason"
+        ],
+        "error_occurred": [
+            "type",
+            "severity",
+            "resolution"
+        ],
+        "execution_end": [
+            "all_metrics"
+        ]
+    }
+}

package/.agent/config/notification-config.json

@@ -0,0 +1,43 @@
+{
+    "notifications": {
+        "enabled": true,
+        "verbosity": "normal",
+        "display": {
+            "agentRouting": true,
+            "skillLoading": true,
+            "scriptExecution": false,
+            "taskCompletion": true
+        },
+        "format": "box"
+    },
+    "verbosityLevels": {
+        "minimal": {
+            "agentRouting": true,
+            "skillLoading": false,
+            "scriptExecution": false,
+            "taskCompletion": true
+        },
+        "normal": {
+            "agentRouting": true,
+            "skillLoading": true,
+            "scriptExecution": false,
+            "taskCompletion": true
+        },
+        "verbose": {
+            "agentRouting": true,
+            "skillLoading": true,
+            "scriptExecution": true,
+            "taskCompletion": true
+        }
+    },
+    "logging": {
+        "enabled": false,
+        "path": ".agent/logs/execution-history.jsonl",
+        "retention": "7d"
+    },
+    "formatting": {
+        "boxStyle": "unicode",
+        "useColors": true,
+        "showTimestamps": false
+    }
+}

package/.agent/knowledge/README.md

@@ -0,0 +1,95 @@
+# Knowledge Base
+
+> Agent learning storage with FAANG-standard indexing and schema validation.
+
+---
+
+## 📂 Structure
+
+```
+knowledge/
+├── index.json           # Searchable index (pattern, tag, severity)
+├── lessons-learned.yaml # Extracted lessons from failures
+├── mistakes.yaml        # Error patterns to avoid
+├── improvements.yaml    # Improvement suggestions
+├── autopilot-metrics.json # Performance metrics
+├── autopilot-runs.json  # Execution history
+├── evolution-signals.json # Learning signals
+├── taxonomy.yaml        # Pattern categorization
+├── retention.yaml       # What to remember
+├── settings.yaml        # Configuration
+├── schema/              # JSON Schema validation
+│   ├── common.schema.json
+│   ├── mistakes.schema.json
+│   ├── improvements.schema.json
+│   ├── evolution-signals.schema.json
+│   └── settings.schema.json
+├── scans/               # Security/code scan results
+└── backups/             # Automatic backups
+```
+
+---
+
+## 🎯 Purpose
+
+| File | Purpose |
+|------|---------|
+| `index.json` | Fast lookup by pattern, tag, or severity |
+| `lessons-learned` | Lessons from task failures |
+| `mistakes` | Anti-patterns to detect and warn |
+| `improvements` | Suggested code improvements |
+| `taxonomy` | Pattern classification hierarchy |
+
+---
+
+## 📊 Index Structure
+
+```json
+{
+  "version": 1,
+  "patternIndex": { "pattern": ["ID-001"] },
+  "tagIndex": { "tag": ["ID-001"] },
+  "severityIndex": { "ERROR": ["ID-001"] },
+  "idIndex": {
+    "ID-001": {
+      "pattern": "...",
+      "message": "...",
+      "severity": "ERROR|WARNING|INFO",
+      "hitCount": 0,
+      "confidence": 0.95
+    }
+  }
+}
+```
+
+---
+
+## 🔧 Usage
+
+```typescript
+// Load index
+import index from '.agent/knowledge/index.json';
+
+// Find by pattern
+const ids = index.patternIndex['customSelect'];
+
+// Get details
+const detail = index.idIndex['MISTAKE-005'];
+```
+
+---
+
+## 📋 Schema Validation
+
+All files validated against JSON Schema in `schema/`:
+
+```bash
+# Validate a file
+npx ajv validate -s schema/mistakes.schema.json -d mistakes.yaml
+```
+
+---
+
+## 🔄 Backup
+
+Automatic backups stored in `backups/` with timestamp naming.

package/.agent/knowledge/_migration_backup/lessons-learned_2026-01-27T07-45-58.862Z.yaml

@@ -0,0 +1,55 @@
+version: 1
+lessons:
+  - id: LEARN-003
+    pattern: rebranding
+    message: 'When rebranding: NEVER create new simplified file. COPY original first, then edit branding only.'
+    severity: ERROR
+    category: file-safety
+    source: manual
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-25T05:37:29.714Z'
+  - id: LEARN-004
+    pattern: import.*from.*["'](\.\/|\.\.\/)
+    message: 'Before import: verify function exists in target module. Common errors: getLearnedPatterns (use db.lessons), saveKnowledge (in recall.js not common.js)'
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 693
+    lastHit: '2026-01-27T06:58:14.175Z'
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+    excludePaths:
+      - '*.test.js'
+      - '*.spec.js'
+  - id: LEARN-005
+    pattern: customSelect
+    message: NEVER use customSelect - conflicts with Clack ESC handling. Always use p.select() + p.isCancel() for consistent navigation
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 22
+    lastHit: '2026-01-27T06:58:14.173Z'
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+  - id: LEARN-006
+    pattern: function\s+\w+Menu.*\{[\s\S]*\1\(
+    message: Avoid recursive menu calls - causes state issues and bugs. Use while(true) loop for menu navigation instead
+    severity: WARNING
+    category: architecture
+    source: auto-conversation
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+  - id: LEARN-007
+    pattern: p\.select.*===\s*(null|undefined)
+    message: After p.select(), use p.isCancel() not null/undefined check. Null check does NOT detect ESC key properly
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'

package/.agent/knowledge/_needs_review.yaml

@@ -0,0 +1,24 @@
+note: These lessons contained both mistake and improvement keywords and were auto-split. Please review.
+items:
+  - id: LEARN-005
+    pattern: customSelect
+    message: NEVER use customSelect - conflicts with Clack ESC handling. Always use p.select() + p.isCancel() for consistent navigation
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 22
+    lastHit: '2026-01-27T06:58:14.173Z'
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+    reason: Mixed mistake + improvement keywords, auto-split but needs verification
+  - id: LEARN-006
+    pattern: function\s+\w+Menu.*\{[\s\S]*\1\(
+    message: Avoid recursive menu calls - causes state issues and bugs. Use while(true) loop for menu navigation instead
+    severity: WARNING
+    category: architecture
+    source: auto-conversation
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+    reason: Mixed mistake + improvement keywords, auto-split but needs verification

package/.agent/knowledge/autopilot-metrics.json

@@ -0,0 +1,93 @@
+{
+  "executions": [
+    {
+      "taskId": "AP-mkz2oo4q-caqwdc",
+      "metadata": {
+        "task": "build todo app",
+        "domains": [
+          "frontend",
+          "backend"
+        ],
+        "complexity": "standard",
+        "riskLevel": "LOW"
+      },
+      "timestamp": "2026-01-29T06:28:03.650Z",
+      "startTime": "2026-01-29T06:28:03.243Z",
+      "endTime": "2026-01-29T06:28:03.650Z",
+      "metrics": {
+        "totalDuration": 407,
+        "averagePhaseTime": 101.75,
+        "humanInterventions": 0,
+        "approvalPrompts": 0,
+        "autonomousCompletionRate": 100,
+        "autoFixRate": 100,
+        "firstTimeSuccess": true,
+        "errorRate": 0,
+        "retryCount": 0,
+        "agentDecisionDepth": 0,
+        "skillReuseRatio": 0,
+        "totalPhases": 4,
+        "successfulPhases": 4,
+        "failedPhases": 0,
+        "totalErrors": 0,
+        "autoFixedErrors": 0,
+        "uniqueSkillsUsed": 0,
+        "totalSkillInvocations": 0,
+        "checkpointsCreated": 0
+      },
+      "phases": [
+        {
+          "name": "planning",
+          "duration": 266.88180360724414,
+          "status": "success",
+          "timestamp": 1769668083343
+        },
+        {
+          "name": "setup",
+          "duration": 244.5966061183591,
+          "status": "success",
+          "timestamp": 1769668083445
+        },
+        {
+          "name": "execution",
+          "duration": 225.43868534311258,
+          "status": "success",
+          "timestamp": 1769668083549
+        },
+        {
+          "name": "verification",
+          "duration": 215.13346533909908,
+          "status": "success",
+          "timestamp": 1769668083649
+        }
+      ],
+      "errors": [],
+      "interventions": [],
+      "agentInvocations": [],
+      "skillInvocations": [],
+      "checkpoints": []
+    }
+  ],
+  "baseline": {
+    "totalDuration": 407,
+    "averagePhaseTime": 101.75,
+    "humanInterventions": 0,
+    "approvalPrompts": 0,
+    "autonomousCompletionRate": 100,
+    "autoFixRate": 100,
+    "firstTimeSuccess": true,
+    "errorRate": 0,
+    "retryCount": 0,
+    "agentDecisionDepth": 0,
+    "skillReuseRatio": 0,
+    "totalPhases": 4,
+    "successfulPhases": 4,
+    "failedPhases": 0,
+    "totalErrors": 0,
+    "autoFixedErrors": 0,
+    "uniqueSkillsUsed": 0,
+    "totalSkillInvocations": 0,
+    "checkpointsCreated": 0
+  },
+  "baselineTimestamp": "2026-01-29T06:28:03.650Z"
+}

package/.agent/knowledge/autopilot-runs.json

@@ -0,0 +1,11 @@
+[
+  {
+    "taskId": "AP-mkz2oo4q-caqwdc",
+    "task": "build todo app",
+    "timestamp": "2026-01-29T06:28:03.650Z",
+    "riskLevel": "LOW",
+    "duration": 407,
+    "success": true,
+    "interventions": 0
+  }
+]

package/.agent/knowledge/backups/2026-01-25T17-08-04-097Z/lessons-learned.yaml

@@ -0,0 +1,12 @@
+version: 1
+lessons:
+  - id: LEARN-003
+    pattern: rebranding
+    message: 'When rebranding: NEVER create new simplified file. COPY original first, then edit branding only.'
+    severity: ERROR
+    category: file-safety
+    source: manual
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-25T05:37:29.714Z'

package/.agent/knowledge/backups/2026-01-25T17-08-04-097Z/settings.yaml

@@ -0,0 +1,5 @@
+version: 1
+autoLearning: true
+autoUpdating: false
+updateThreshold: 5
+lastUpdateCheck: null

package/.agent/knowledge/backups/2026-01-25T17-08-08-345Z/lessons-learned.yaml

@@ -0,0 +1,12 @@
+version: 1
+lessons:
+  - id: LEARN-003
+    pattern: rebranding
+    message: 'When rebranding: NEVER create new simplified file. COPY original first, then edit branding only.'
+    severity: ERROR
+    category: file-safety
+    source: manual
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-25T05:37:29.714Z'

package/.agent/knowledge/backups/2026-01-25T17-08-08-345Z/settings.yaml

@@ -0,0 +1,5 @@
+version: 1
+autoLearning: true
+autoUpdating: false
+updateThreshold: 5
+lastUpdateCheck: null

package/.agent/knowledge/backups/2026-01-25T17-08-09-232Z/lessons-learned.yaml

@@ -0,0 +1,12 @@
+version: 1
+lessons:
+  - id: LEARN-003
+    pattern: rebranding
+    message: 'When rebranding: NEVER create new simplified file. COPY original first, then edit branding only.'
+    severity: ERROR
+    category: file-safety
+    source: manual
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-25T05:37:29.714Z'

package/.agent/knowledge/backups/2026-01-25T17-08-09-232Z/settings.yaml

@@ -0,0 +1,5 @@
+version: 1
+autoLearning: true
+autoUpdating: false
+updateThreshold: 5
+lastUpdateCheck: null

package/.agent/knowledge/backups/2026-01-29T15-15-32-715Z/lessons-learned.yaml

@@ -0,0 +1,37 @@
+# Lessons Learned
+# Auto-generated by self-evolution skill
+# Format: id, pattern, severity, message, date
+
+- id: LEARN-001
+  pattern: "Completing task without checking @[current_problems]"
+  severity: CRITICAL
+  message: |
+    MUST check @[current_problems] before ANY notify_user call or task completion.
+    If errors/warnings > 0:
+    1. Auto-fix if possible (imports, types, lint)
+    2. Re-check @[current_problems]
+    3. If still > 0 → STOP → Escalate to user
+    Never mark task complete with IDE errors.
+  date: "2026-01-29"
+  trigger: "/build, /autopilot, task completion"
+  fix_applied: true
+  fix_location:
+    - ".agent/workflows/autopilot.md"
+    - ".agent/workflows/build.md"
+
+- id: LEARN-002
+  pattern: "Using JSX.Element without importing React in TypeScript"
+  severity: HIGH
+  message: |
+    In React 18+ with TypeScript, JSX namespace may not be globally available.
+    Use `import { ReactNode } from 'react'` and type as `ReactNode` instead of `JSX.Element`.
+  date: "2026-01-29"
+  trigger: "TypeScript errors, JSX namespace"
+  fix_applied: true
+  example_fix: |
+    // Before
+    const icons: Record<string, JSX.Element> = { ... }
+
+    // After
+    import { ReactNode } from 'react';
+    const icons: Record<string, ReactNode> = { ... }

package/.agent/knowledge/backups/2026-01-29T15-15-32-715Z/settings.yaml

@@ -0,0 +1,24 @@
+version: 1
+autoLearning: true
+autoUpdating: true
+updateThreshold: 10
+lastUpdateCheck: null
+apiKeys:
+  gemini: null
+  claude: null
+
+# Retention settings (Phase 4)
+retention:
+  enabled: false # MUST be explicitly enabled
+  archiveAfterDays: 90
+  deleteAfterDays: 180
+
+# Indexing settings (Phase 2)
+indexing:
+  enabled: true
+  autoRebuild: true
+
+# Metrics settings (Phase 3)
+metrics:
+  enabled: true
+  collectInterval: onScan # onScan, daily, weekly

package/.agent/knowledge/backups/lessons-learned.yaml.archived

@@ -0,0 +1,58 @@
+version: 1
+lessons:
+  - id: LEARN-003
+    pattern: rebranding
+    message: 'When rebranding: NEVER create new simplified file. COPY original first, then edit branding only.'
+    severity: ERROR
+    category: file-safety
+    source: manual
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-25T05:37:29.714Z'
+    excludePaths:
+      - '**/examples/**'
+      - '**/demo*.js'
+      - '**/test*.js'
+  - id: LEARN-005
+    pattern: customSelect
+    message: NEVER use customSelect - conflicts with Clack ESC handling. Always use p.select() + p.isCancel() for consistent navigation
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 22
+    lastHit: '2026-01-27T06:58:14.173Z'
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+    excludePaths:
+      - '**/examples/**'
+      - '**/demo*.js'
+      - '**/custom-select.js'
+    autoFix:
+      type: "regex-replace"
+      find: "customSelect"
+      replace: "p.select"
+  - id: LEARN-006
+    pattern: function\s+\w+Menu.*\{[\s\S]*\1\(
+    message: Avoid recursive menu calls - causes state issues and bugs. Use while(true) loop for menu navigation instead
+    severity: WARNING
+    category: architecture
+    source: auto-conversation
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+  - id: LEARN-007
+    pattern: p\.select.*===\s*(null|undefined)
+    message: After p.select(), use p.isCancel() not null/undefined check. Null check does NOT detect ESC key properly
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+    autoFix:
+      type: "regex-replace"
+      find: "===\\s*(null|undefined)"
+      replace: "p.isCancel($VAR)"

package/.agent/knowledge/backups/lessons-learned.yaml.bak-20260128-180048

@@ -0,0 +1,58 @@
+version: 1
+lessons:
+  - id: LEARN-003
+    pattern: rebranding
+    message: 'When rebranding: NEVER create new simplified file. COPY original first, then edit branding only.'
+    severity: ERROR
+    category: file-safety
+    source: manual
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-25T05:37:29.714Z'
+    excludePaths:
+      - '**/examples/**'
+      - '**/demo*.js'
+      - '**/test*.js'
+  - id: LEARN-005
+    pattern: customSelect
+    message: NEVER use customSelect - conflicts with Clack ESC handling. Always use p.select() + p.isCancel() for consistent navigation
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 22
+    lastHit: '2026-01-27T06:58:14.173Z'
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+    excludePaths:
+      - '**/examples/**'
+      - '**/demo*.js'
+      - '**/custom-select.js'
+    autoFix:
+      type: "regex-replace"
+      find: "customSelect"
+      replace: "p.select"
+  - id: LEARN-006
+    pattern: function\s+\w+Menu.*\{[\s\S]*\1\(
+    message: Avoid recursive menu calls - causes state issues and bugs. Use while(true) loop for menu navigation instead
+    severity: WARNING
+    category: architecture
+    source: auto-conversation
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+  - id: LEARN-007
+    pattern: p\.select.*===\s*(null|undefined)
+    message: After p.select(), use p.isCancel() not null/undefined check. Null check does NOT detect ESC key properly
+    severity: ERROR
+    category: code-quality
+    source: auto-conversation
+    hitCount: 0
+    lastHit: null
+    autoEscalated: false
+    addedAt: '2026-01-27T08:47:00.000Z'
+    autoFix:
+      type: "regex-replace"
+      find: "===\\s*(null|undefined)"
+      replace: "p.isCancel($VAR)"

package/.agent/knowledge/backups/lessons.yaml.archived

@@ -0,0 +1,2 @@
+lessons: []
+version: 1

package/.agent/knowledge/detected-errors.json

@@ -0,0 +1,5 @@
+{
+  "_comment": "Auto-detected errors by error_sensor",
+  "errors": [],
+  "lastScan": null
+}