@fprad0/skill-master-mcp 0.0.12 → 1.0.0

package/docs/skill-candidates/v0.0.11/typescript-expert/scripts/ts_diagnostic.py

@@ -1,203 +1,203 @@
-#!/usr/bin/env python3
-"""
-TypeScript Project Diagnostic Script
-Analyzes TypeScript projects for configuration, performance, and common issues.
-"""
-
-import subprocess
-import sys
-import os
-import json
-from pathlib import Path
-
-def run_cmd(cmd: str) -> str:
-    """Run shell command and return output."""
-    try:
-        result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
-        return result.stdout + result.stderr
-    except Exception as e:
-        return str(e)
-
-def check_versions():
-    """Check TypeScript and Node versions."""
-    print("\n📦 Versions:")
-    print("-" * 40)
-    
-    ts_version = run_cmd("npx tsc --version 2>/dev/null").strip()
-    node_version = run_cmd("node -v 2>/dev/null").strip()
-    
-    print(f"  TypeScript: {ts_version or 'Not found'}")
-    print(f"  Node.js: {node_version or 'Not found'}")
-
-def check_tsconfig():
-    """Analyze tsconfig.json settings."""
-    print("\n⚙️ TSConfig Analysis:")
-    print("-" * 40)
-    
-    tsconfig_path = Path("tsconfig.json")
-    if not tsconfig_path.exists():
-        print("⚠️ tsconfig.json not found")
-        return
-    
-    try:
-        with open(tsconfig_path) as f:
-            config = json.load(f)
-        
-        compiler_opts = config.get("compilerOptions", {})
-        
-        # Check strict mode
-        if compiler_opts.get("strict"):
-            print("✅ Strict mode enabled")
-        else:
-            print("⚠️ Strict mode NOT enabled")
-        
-        # Check important flags
-        flags = {
-            "noUncheckedIndexedAccess": "Unchecked index access protection",
-            "noImplicitOverride": "Implicit override protection",
-            "skipLibCheck": "Skip lib check (performance)",
-            "incremental": "Incremental compilation"
-        }
-        
-        for flag, desc in flags.items():
-            status = "✅" if compiler_opts.get(flag) else "⚪"
-            print(f"  {status} {desc}: {compiler_opts.get(flag, 'not set')}")
-        
-        # Check module settings
-        print(f"\n  Module: {compiler_opts.get('module', 'not set')}")
-        print(f"  Module Resolution: {compiler_opts.get('moduleResolution', 'not set')}")
-        print(f"  Target: {compiler_opts.get('target', 'not set')}")
-        
-    except json.JSONDecodeError:
-        print("❌ Invalid JSON in tsconfig.json")
-
-def check_tooling():
-    """Detect TypeScript tooling ecosystem."""
-    print("\n🛠️ Tooling Detection:")
-    print("-" * 40)
-    
-    pkg_path = Path("package.json")
-    if not pkg_path.exists():
-        print("⚠️ package.json not found")
-        return
-    
-    try:
-        with open(pkg_path) as f:
-            pkg = json.load(f)
-        
-        all_deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
-        
-        tools = {
-            "biome": "Biome (linter/formatter)",
-            "eslint": "ESLint",
-            "prettier": "Prettier",
-            "vitest": "Vitest (testing)",
-            "jest": "Jest (testing)",
-            "turborepo": "Turborepo (monorepo)",
-            "turbo": "Turbo (monorepo)",
-            "nx": "Nx (monorepo)",
-            "lerna": "Lerna (monorepo)"
-        }
-        
-        for tool, desc in tools.items():
-            for dep in all_deps:
-                if tool in dep.lower():
-                    print(f"  ✅ {desc}")
-                    break
-                    
-    except json.JSONDecodeError:
-        print("❌ Invalid JSON in package.json")
-
-def check_monorepo():
-    """Check for monorepo configuration."""
-    print("\n📦 Monorepo Check:")
-    print("-" * 40)
-    
-    indicators = [
-        ("pnpm-workspace.yaml", "PNPM Workspace"),
-        ("lerna.json", "Lerna"),
-        ("nx.json", "Nx"),
-        ("turbo.json", "Turborepo")
-    ]
-    
-    found = False
-    for file, name in indicators:
-        if Path(file).exists():
-            print(f"  ✅ {name} detected")
-            found = True
-    
-    if not found:
-        print("  ⚪ No monorepo configuration detected")
-
-def check_type_errors():
-    """Run quick type check."""
-    print("\n🔍 Type Check:")
-    print("-" * 40)
-    
-    result = run_cmd("npx tsc --noEmit 2>&1 | head -20")
-    if "error TS" in result:
-        errors = result.count("error TS")
-        print(f"  ❌ {errors}+ type errors found")
-        print(result[:500])
-    else:
-        print("  ✅ No type errors")
-
-def check_any_usage():
-    """Check for any type usage."""
-    print("\n⚠️ 'any' Type Usage:")
-    print("-" * 40)
-    
-    result = run_cmd("grep -r ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | wc -l")
-    count = result.strip()
-    if count and count != "0":
-        print(f"  ⚠️ Found {count} occurrences of ': any'")
-        sample = run_cmd("grep -rn ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | head -5")
-        if sample:
-            print(sample)
-    else:
-        print("  ✅ No explicit 'any' types found")
-
-def check_type_assertions():
-    """Check for type assertions."""
-    print("\n⚠️ Type Assertions (as):")
-    print("-" * 40)
-    
-    result = run_cmd("grep -r ' as ' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | grep -v 'import' | wc -l")
-    count = result.strip()
-    if count and count != "0":
-        print(f"  ⚠️ Found {count} type assertions")
-    else:
-        print("  ✅ No type assertions found")
-
-def check_performance():
-    """Check type checking performance."""
-    print("\n⏱️ Type Check Performance:")
-    print("-" * 40)
-    
-    result = run_cmd("npx tsc --extendedDiagnostics --noEmit 2>&1 | grep -E 'Check time|Files:|Lines:|Nodes:'")
-    if result.strip():
-        for line in result.strip().split('\n'):
-            print(f"  {line}")
-    else:
-        print("  ⚠️ Could not measure performance")
-
-def main():
-    print("=" * 50)
-    print("🔍 TypeScript Project Diagnostic Report")
-    print("=" * 50)
-    
-    check_versions()
-    check_tsconfig()
-    check_tooling()
-    check_monorepo()
-    check_any_usage()
-    check_type_assertions()
-    check_type_errors()
-    check_performance()
-    
-    print("\n" + "=" * 50)
-    print("✅ Diagnostic Complete")
-    print("=" * 50)
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""
+TypeScript Project Diagnostic Script
+Analyzes TypeScript projects for configuration, performance, and common issues.
+"""
+
+import subprocess
+import sys
+import os
+import json
+from pathlib import Path
+
+def run_cmd(cmd: str) -> str:
+    """Run shell command and return output."""
+    try:
+        result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
+        return result.stdout + result.stderr
+    except Exception as e:
+        return str(e)
+
+def check_versions():
+    """Check TypeScript and Node versions."""
+    print("\n📦 Versions:")
+    print("-" * 40)
+    
+    ts_version = run_cmd("npx tsc --version 2>/dev/null").strip()
+    node_version = run_cmd("node -v 2>/dev/null").strip()
+    
+    print(f"  TypeScript: {ts_version or 'Not found'}")
+    print(f"  Node.js: {node_version or 'Not found'}")
+
+def check_tsconfig():
+    """Analyze tsconfig.json settings."""
+    print("\n⚙️ TSConfig Analysis:")
+    print("-" * 40)
+    
+    tsconfig_path = Path("tsconfig.json")
+    if not tsconfig_path.exists():
+        print("⚠️ tsconfig.json not found")
+        return
+    
+    try:
+        with open(tsconfig_path) as f:
+            config = json.load(f)
+        
+        compiler_opts = config.get("compilerOptions", {})
+        
+        # Check strict mode
+        if compiler_opts.get("strict"):
+            print("✅ Strict mode enabled")
+        else:
+            print("⚠️ Strict mode NOT enabled")
+        
+        # Check important flags
+        flags = {
+            "noUncheckedIndexedAccess": "Unchecked index access protection",
+            "noImplicitOverride": "Implicit override protection",
+            "skipLibCheck": "Skip lib check (performance)",
+            "incremental": "Incremental compilation"
+        }
+        
+        for flag, desc in flags.items():
+            status = "✅" if compiler_opts.get(flag) else "⚪"
+            print(f"  {status} {desc}: {compiler_opts.get(flag, 'not set')}")
+        
+        # Check module settings
+        print(f"\n  Module: {compiler_opts.get('module', 'not set')}")
+        print(f"  Module Resolution: {compiler_opts.get('moduleResolution', 'not set')}")
+        print(f"  Target: {compiler_opts.get('target', 'not set')}")
+        
+    except json.JSONDecodeError:
+        print("❌ Invalid JSON in tsconfig.json")
+
+def check_tooling():
+    """Detect TypeScript tooling ecosystem."""
+    print("\n🛠️ Tooling Detection:")
+    print("-" * 40)
+    
+    pkg_path = Path("package.json")
+    if not pkg_path.exists():
+        print("⚠️ package.json not found")
+        return
+    
+    try:
+        with open(pkg_path) as f:
+            pkg = json.load(f)
+        
+        all_deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
+        
+        tools = {
+            "biome": "Biome (linter/formatter)",
+            "eslint": "ESLint",
+            "prettier": "Prettier",
+            "vitest": "Vitest (testing)",
+            "jest": "Jest (testing)",
+            "turborepo": "Turborepo (monorepo)",
+            "turbo": "Turbo (monorepo)",
+            "nx": "Nx (monorepo)",
+            "lerna": "Lerna (monorepo)"
+        }
+        
+        for tool, desc in tools.items():
+            for dep in all_deps:
+                if tool in dep.lower():
+                    print(f"  ✅ {desc}")
+                    break
+                    
+    except json.JSONDecodeError:
+        print("❌ Invalid JSON in package.json")
+
+def check_monorepo():
+    """Check for monorepo configuration."""
+    print("\n📦 Monorepo Check:")
+    print("-" * 40)
+    
+    indicators = [
+        ("pnpm-workspace.yaml", "PNPM Workspace"),
+        ("lerna.json", "Lerna"),
+        ("nx.json", "Nx"),
+        ("turbo.json", "Turborepo")
+    ]
+    
+    found = False
+    for file, name in indicators:
+        if Path(file).exists():
+            print(f"  ✅ {name} detected")
+            found = True
+    
+    if not found:
+        print("  ⚪ No monorepo configuration detected")
+
+def check_type_errors():
+    """Run quick type check."""
+    print("\n🔍 Type Check:")
+    print("-" * 40)
+    
+    result = run_cmd("npx tsc --noEmit 2>&1 | head -20")
+    if "error TS" in result:
+        errors = result.count("error TS")
+        print(f"  ❌ {errors}+ type errors found")
+        print(result[:500])
+    else:
+        print("  ✅ No type errors")
+
+def check_any_usage():
+    """Check for any type usage."""
+    print("\n⚠️ 'any' Type Usage:")
+    print("-" * 40)
+    
+    result = run_cmd("grep -r ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | wc -l")
+    count = result.strip()
+    if count and count != "0":
+        print(f"  ⚠️ Found {count} occurrences of ': any'")
+        sample = run_cmd("grep -rn ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | head -5")
+        if sample:
+            print(sample)
+    else:
+        print("  ✅ No explicit 'any' types found")
+
+def check_type_assertions():
+    """Check for type assertions."""
+    print("\n⚠️ Type Assertions (as):")
+    print("-" * 40)
+    
+    result = run_cmd("grep -r ' as ' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | grep -v 'import' | wc -l")
+    count = result.strip()
+    if count and count != "0":
+        print(f"  ⚠️ Found {count} type assertions")
+    else:
+        print("  ✅ No type assertions found")
+
+def check_performance():
+    """Check type checking performance."""
+    print("\n⏱️ Type Check Performance:")
+    print("-" * 40)
+    
+    result = run_cmd("npx tsc --extendedDiagnostics --noEmit 2>&1 | grep -E 'Check time|Files:|Lines:|Nodes:'")
+    if result.strip():
+        for line in result.strip().split('\n'):
+            print(f"  {line}")
+    else:
+        print("  ⚠️ Could not measure performance")
+
+def main():
+    print("=" * 50)
+    print("🔍 TypeScript Project Diagnostic Report")
+    print("=" * 50)
+    
+    check_versions()
+    check_tsconfig()
+    check_tooling()
+    check_monorepo()
+    check_any_usage()
+    check_type_assertions()
+    check_type_errors()
+    check_performance()
+    
+    print("\n" + "=" * 50)
+    print("✅ Diagnostic Complete")
+    print("=" * 50)
+
+if __name__ == "__main__":
+    main()

package/docs/skill-candidates/v0.0.11/ui-component-primitives/SKILL.md

@@ -1,34 +1,34 @@
----
-name: ui-component-primitives
-description: "Design and implement reusable UI primitives and interaction components such as buttons, inputs, cards, modals, dropdowns, icons, toasts and navigation with accessibility and state clarity."
----
-
-# UI Component Primitives
-
-Use this skill when the task is about reusable UI building blocks rather than page-level layout alone.
-
-## Workflow
-
-- Start from the interaction contract: trigger, focus, keyboard, dismissal and state changes.
-- Define component API, variants and states before styling details.
-- Treat modal, dropdown, popover and navigation primitives as accessibility-sensitive systems.
-- Keep icons, labels, spacing and motion consistent with the design system.
-- Validate both mouse and keyboard behavior.
-
-## Coverage
-
-- Components, primitives, modals, dropdowns, popovers, icons, buttons, forms and feedback.
-- Variants, states, accessibility, composition and design-system reuse.
-- Desktop and mobile interaction expectations.
-
-## Reference Anchors
-
-- WAI-ARIA APG: `https://www.w3.org/WAI/ARIA/apg/`
-- Material Design components: `https://m3.material.io/components`
-
-## Guardrails
-
-- Do not ship inaccessible focus, escape or keyboard behavior.
-- Do not let visual styling outrun interaction correctness.
-- Do not duplicate primitives without a strong reason.
-- Do not ignore empty, loading, disabled or error states.
+---
+name: ui-component-primitives
+description: "Design and implement reusable UI primitives and interaction components such as buttons, inputs, cards, modals, dropdowns, icons, toasts and navigation with accessibility and state clarity."
+---
+
+# UI Component Primitives
+
+Use this skill when the task is about reusable UI building blocks rather than page-level layout alone.
+
+## Workflow
+
+- Start from the interaction contract: trigger, focus, keyboard, dismissal and state changes.
+- Define component API, variants and states before styling details.
+- Treat modal, dropdown, popover and navigation primitives as accessibility-sensitive systems.
+- Keep icons, labels, spacing and motion consistent with the design system.
+- Validate both mouse and keyboard behavior.
+
+## Coverage
+
+- Components, primitives, modals, dropdowns, popovers, icons, buttons, forms and feedback.
+- Variants, states, accessibility, composition and design-system reuse.
+- Desktop and mobile interaction expectations.
+
+## Reference Anchors
+
+- WAI-ARIA APG: `https://www.w3.org/WAI/ARIA/apg/`
+- Material Design components: `https://m3.material.io/components`
+
+## Guardrails
+
+- Do not ship inaccessible focus, escape or keyboard behavior.
+- Do not let visual styling outrun interaction correctness.
+- Do not duplicate primitives without a strong reason.
+- Do not ignore empty, loading, disabled or error states.

package/docs/skill-candidates/v0.0.11/web-mobile-design-systems/SKILL.md

@@ -1,34 +1,34 @@
----
-name: web-mobile-design-systems
-description: "Shape coherent web, mobile and app-facing design systems with attention to layout, hierarchy, navigation, responsive behavior, visual language and product-level usability."
----
-
-# Web Mobile Design Systems
-
-Use this skill when the task spans layout, visual systems and product interaction across desktop and mobile surfaces.
-
-## Workflow
-
-- Begin from information hierarchy, navigation and user goal flow.
-- Design responsive layout behavior before polishing isolated screens.
-- Keep typography, spacing, surface hierarchy and motion consistent across breakpoints.
-- Reuse patterns deliberately across web and mobile contexts while respecting platform differences.
-- Validate readability, rhythm and interaction clarity on both narrow and wide layouts.
-
-## Coverage
-
-- Layout, web design, mobile, app surfaces, UX/UI systems and responsive behavior.
-- Navigation, forms, cards, sections, density, hierarchy, motion and visual consistency.
-- Design-system framing for product teams.
-
-## Reference Anchors
-
-- Material Design 3: `https://m3.material.io/`
-- Apple Human Interface Guidelines: `https://developer.apple.com/design/human-interface-guidelines/`
-
-## Guardrails
-
-- Do not confuse visual complexity with product quality.
-- Do not force desktop structure onto mobile flows.
-- Do not treat responsiveness as a late patch.
-- Do not sacrifice clarity for novelty.
+---
+name: web-mobile-design-systems
+description: "Shape coherent web, mobile and app-facing design systems with attention to layout, hierarchy, navigation, responsive behavior, visual language and product-level usability."
+---
+
+# Web Mobile Design Systems
+
+Use this skill when the task spans layout, visual systems and product interaction across desktop and mobile surfaces.
+
+## Workflow
+
+- Begin from information hierarchy, navigation and user goal flow.
+- Design responsive layout behavior before polishing isolated screens.
+- Keep typography, spacing, surface hierarchy and motion consistent across breakpoints.
+- Reuse patterns deliberately across web and mobile contexts while respecting platform differences.
+- Validate readability, rhythm and interaction clarity on both narrow and wide layouts.
+
+## Coverage
+
+- Layout, web design, mobile, app surfaces, UX/UI systems and responsive behavior.
+- Navigation, forms, cards, sections, density, hierarchy, motion and visual consistency.
+- Design-system framing for product teams.
+
+## Reference Anchors
+
+- Material Design 3: `https://m3.material.io/`
+- Apple Human Interface Guidelines: `https://developer.apple.com/design/human-interface-guidelines/`
+
+## Guardrails
+
+- Do not confuse visual complexity with product quality.
+- Do not force desktop structure onto mobile flows.
+- Do not treat responsiveness as a late patch.
+- Do not sacrifice clarity for novelty.

package/docs/skill-candidates/v0.0.11/windows-linux-platform-ops/SKILL.md

@@ -1,34 +1,34 @@
----
-name: windows-linux-platform-ops
-description: "Operate Windows and Linux developer environments with focus on filesystems, PATH, permissions, services, shells, package managers and cross-platform reliability."
----
-
-# Windows Linux Platform Ops
-
-Use this skill when the task depends on OS-specific environment behavior across Windows or Linux.
-
-## Workflow
-
-- Identify the target OS, shell, path conventions and permission model first.
-- Treat filesystem, service, environment and package-manager differences explicitly.
-- Prefer cross-platform instructions only when they are truly equivalent.
-- Keep operator-facing paths, config locations and restart steps concrete.
-- Validate on the real platform path when possible.
-
-## Coverage
-
-- Windows and Linux paths, permissions, PATH, services, package managers and shells.
-- Config-file locations, CLI registration, restart/reload behavior and troubleshooting.
-- Cross-platform readiness for developer tooling.
-
-## Reference Anchors
-
-- Windows docs: `https://learn.microsoft.com/windows/`
-- Linux kernel docs: `https://www.kernel.org/doc/html/latest/`
-
-## Guardrails
-
-- Do not assume Linux semantics on Windows paths or permissions.
-- Do not give cross-platform instructions that are only half-true.
-- Do not omit restart/reload requirements for service or shell config changes.
-- Do not hide elevated-privilege requirements.
+---
+name: windows-linux-platform-ops
+description: "Operate Windows and Linux developer environments with focus on filesystems, PATH, permissions, services, shells, package managers and cross-platform reliability."
+---
+
+# Windows Linux Platform Ops
+
+Use this skill when the task depends on OS-specific environment behavior across Windows or Linux.
+
+## Workflow
+
+- Identify the target OS, shell, path conventions and permission model first.
+- Treat filesystem, service, environment and package-manager differences explicitly.
+- Prefer cross-platform instructions only when they are truly equivalent.
+- Keep operator-facing paths, config locations and restart steps concrete.
+- Validate on the real platform path when possible.
+
+## Coverage
+
+- Windows and Linux paths, permissions, PATH, services, package managers and shells.
+- Config-file locations, CLI registration, restart/reload behavior and troubleshooting.
+- Cross-platform readiness for developer tooling.
+
+## Reference Anchors
+
+- Windows docs: `https://learn.microsoft.com/windows/`
+- Linux kernel docs: `https://www.kernel.org/doc/html/latest/`
+
+## Guardrails
+
+- Do not assume Linux semantics on Windows paths or permissions.
+- Do not give cross-platform instructions that are only half-true.
+- Do not omit restart/reload requirements for service or shell config changes.
+- Do not hide elevated-privilege requirements.

package/docs/skill-candidates/v0.0.12/context-compression-handoff/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: context-compression-handoff
+description: "Create compact continuation or transfer handoffs for long AI work. Use before switching machines, clients, agents, phases, or when a conversation is getting too long."
+---
+
+# Context Compression Handoff
+
+Use this skill to preserve the useful state while dropping token-heavy noise.
+
+## Handoff Structure
+
+```text
+Goal:
+Current status:
+Decisions made:
+Files changed or relevant:
+Commands run and results:
+Open risks:
+Do not do:
+Next actions:
+Source links:
+```
+
+## Compression Rules
+
+- Keep exact file paths and command names.
+- Keep failing error messages, but trim repeated logs.
+- Keep security/auth/publication warnings.
+- Convert long discussion into decisions and rationale.
+- Replace pasted docs with source URLs and one-line relevance.
+- Preserve user preferences that affect implementation.
+
+## When to Use
+
+- Before transferring to another computer.
+- Before publishing/release work.
+- Before opening the same task in another AI client.
+- After research, before implementation.
+- After implementation, before QA.
+- When the agent starts repeating old context.
+
+## Guardrails
+
+- Do not omit unresolved blockers.
+- Do not compress away user approvals or refusals.
+- Do not include secrets, tokens, OTPs, private keys or recovery codes.
+- Do not claim the handoff is complete unless validation status is included.