@agentskillkit/agent-skills 1.0.1 → 3.2.1

package/.agent/archive/registry.json.v1-backup

@@ -0,0 +1,514 @@
+{
+  "updatedAt": "2026-01-28T16:15:00.000Z",
+  "version": "2.0.0",
+  "skills": [
+    {
+      "name": "agent-modes",
+      "category": "core",
+      "triggers": ["mode", "brainstorm", "implement", "debug", "review", "teach", "ship"],
+      "coordinates_with": ["smart-router", "context-optimizer"],
+      "success_metrics": "correct mode selected, behavior adapted",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "api-architect",
+      "category": "architecture",
+      "triggers": ["API design", "REST", "GraphQL", "tRPC", "endpoint", "versioning"],
+      "coordinates_with": ["data-modeler", "security-scanner", "web-core"],
+      "success_metrics": "API documentation complete, endpoints validated",
+      "rules": ["api-style.md", "auth.md", "documentation.md", "graphql.md", "rate-limiting.md", "response.md", "rest.md", "security-testing.md", "trpc.md", "versioning.md"],
+      "scripts": ["api_validator.py"]
+    },
+    {
+      "name": "app-scaffold",
+      "category": "core",
+      "triggers": ["build app", "create project", "new application", "scaffold", "full-stack"],
+      "coordinates_with": ["project-planner", "code-craft", "test-architect", "design-system"],
+      "success_metrics": "project structure created, dependencies installed",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "chaos-engineer",
+      "category": "devops",
+      "triggers": ["chaos", "resilience", "failure injection", "fault tolerance", "disaster recovery"],
+      "coordinates_with": ["perf-optimizer", "security-scanner", "cicd-pipeline"],
+      "success_metrics": "resilience tested, failure scenarios documented",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "cicd-pipeline",
+      "category": "devops",
+      "triggers": ["deploy", "deployment", "CI/CD", "pipeline", "rollback", "release"],
+      "coordinates_with": ["git-workflow", "security-scanner", "feature-flags"],
+      "success_metrics": "pipeline passing, deployment successful",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "code-constitution",
+      "category": "core",
+      "triggers": ["architecture review", "critical data", "breaking change", "governance", "doctrine"],
+      "coordinates_with": ["code-review", "review-automation", "security-scanner"],
+      "success_metrics": "doctrine checks pass, no governance violations",
+      "rules": [],
+      "scripts": ["audit_pr.js", "learn.js", "validate_doctrine.js"]
+    },
+    {
+      "name": "code-craft",
+      "category": "core",
+      "triggers": ["code style", "clean code", "best practices", "naming conventions", "SRP", "DRY", "KISS"],
+      "coordinates_with": ["code-review", "test-architect", "code-quality"],
+      "success_metrics": "code adheres to standards, no linting errors",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "code-quality",
+      "category": "core",
+      "triggers": ["lint", "format", "check", "validate", "types", "static analysis"],
+      "coordinates_with": ["code-craft", "code-review", "test-architect"],
+      "success_metrics": "lint passes, type coverage maintained",
+      "rules": [],
+      "scripts": ["lint_runner.py", "type_coverage.py"]
+    },
+    {
+      "name": "code-review",
+      "category": "core",
+      "triggers": ["review", "PR", "pull request", "audit", "code quality", "security check"],
+      "coordinates_with": ["code-craft", "security-scanner", "test-architect"],
+      "success_metrics": "all blocking issues resolved, security verified",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "context-optimizer",
+      "category": "core",
+      "triggers": ["context", "token usage", "memory system", "agent performance", "LLM pipeline"],
+      "coordinates_with": ["smart-router", "multi-agent", "reasoning-engine"],
+      "success_metrics": "context optimized, token usage reduced",
+      "rules": [],
+      "scripts": ["context_analyzer.py", "compression_evaluator.py"]
+    },
+    {
+      "name": "creative-thinking",
+      "category": "core",
+      "triggers": ["stuck", "innovation", "creative solution", "brainstorm", "alternative approach"],
+      "coordinates_with": ["idea-storm", "reasoning-engine", "project-planner"],
+      "success_metrics": "multiple alternatives generated, solution found",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "data-modeler",
+      "category": "architecture",
+      "triggers": ["database", "schema", "Prisma", "Drizzle", "SQL", "migration", "indexing"],
+      "coordinates_with": ["api-architect", "security-scanner", "nodejs-pro"],
+      "success_metrics": "schema validated, migrations applied",
+      "rules": [],
+      "scripts": ["schema_validator.py"]
+    },
+    {
+      "name": "debug-pro",
+      "category": "core",
+      "triggers": ["debug", "bug", "error", "crash", "exception", "root cause"],
+      "coordinates_with": ["debug-toolkit", "test-architect"],
+      "success_metrics": "bug fixed, root cause identified",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "debug-toolkit",
+      "category": "core",
+      "triggers": ["debug", "bug", "error", "root cause", "investigation", "fix not working"],
+      "coordinates_with": ["test-architect", "code-review", "code-quality"],
+      "success_metrics": "issue resolved, verification complete",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "design-system",
+      "category": "architecture",
+      "triggers": ["design", "UI", "UX", "color palette", "typography", "component design"],
+      "coordinates_with": ["web-core", "tailwind-kit", "visual-excellence"],
+      "success_metrics": "design system consistent, components documented",
+      "rules": ["animation-guide.md", "color-system.md", "decision-trees.md", "motion-graphics.md", "typography-system.md", "ux-psychology.md", "visual-effects.md"],
+      "scripts": ["accessibility_checker.py", "ux_audit.py"]
+    },
+    {
+      "name": "diagram-kit",
+      "category": "specialized",
+      "triggers": ["diagram", "mermaid", "flowchart", "sequence diagram", "architecture diagram"],
+      "coordinates_with": ["doc-processor", "system-design"],
+      "success_metrics": "diagram generated, syntax valid",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "doc-processor",
+      "category": "specialized",
+      "triggers": ["document", "Word", "PDF", "Excel", "PowerPoint", "docx", "xlsx", "pptx"],
+      "coordinates_with": ["doc-templates", "diagram-kit"],
+      "success_metrics": "document processed, format correct",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "doc-templates",
+      "category": "specialized",
+      "triggers": ["template", "README", "documentation", "API docs", "changelog"],
+      "coordinates_with": ["doc-processor", "project-planner"],
+      "success_metrics": "template applied, documentation complete",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "e2e-automation",
+      "category": "testing",
+      "triggers": ["E2E test", "Playwright", "browser test", "visual testing", "automation"],
+      "coordinates_with": ["test-architect", "perf-optimizer", "cicd-pipeline"],
+      "success_metrics": "E2E tests pass, coverage adequate",
+      "rules": [],
+      "scripts": ["playwright_runner.py"]
+    },
+    {
+      "name": "feature-flags",
+      "category": "devops",
+      "triggers": ["feature flag", "A/B test", "rollout", "toggle", "kill switch", "experiment"],
+      "coordinates_with": ["cicd-pipeline", "perf-optimizer"],
+      "success_metrics": "flags configured, rollout controlled",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "game-engine",
+      "category": "framework",
+      "triggers": ["game", "Unity", "Godot", "Phaser", "game engine", "2D", "3D"],
+      "coordinates_with": ["perf-optimizer", "mobile-first"],
+      "success_metrics": "game runs, no crashes",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "geo-spatial",
+      "category": "specialized",
+      "triggers": ["GEO", "AI search", "citations", "Perplexity", "AI visibility"],
+      "coordinates_with": ["seo-optimizer", "web-core"],
+      "success_metrics": "AI citation rate improved, content structured",
+      "rules": [],
+      "scripts": ["geo_checker.py"]
+    },
+    {
+      "name": "git-workflow",
+      "category": "devops",
+      "triggers": ["git", "commit", "branch", "merge", "PR", "conventional commits"],
+      "coordinates_with": ["code-review", "review-automation", "cicd-pipeline"],
+      "success_metrics": "commits follow convention, history traceable",
+      "rules": [],
+      "scripts": ["format-commit.js"]
+    },
+    {
+      "name": "globalization-kit",
+      "category": "specialized",
+      "triggers": ["i18n", "l10n", "translation", "localization", "internationalization", "language"],
+      "coordinates_with": ["web-core", "mobile-first"],
+      "success_metrics": "translations complete, RTL handled",
+      "rules": [],
+      "scripts": ["i18n_checker.py"]
+    },
+    {
+      "name": "idea-storm",
+      "category": "core",
+      "triggers": ["brainstorm", "understand requirements", "clarify", "unclear", "complex request"],
+      "coordinates_with": ["project-planner", "creative-thinking", "app-scaffold"],
+      "success_metrics": "requirements clear, approach defined",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "mcp-server",
+      "category": "framework",
+      "triggers": ["MCP", "Model Context Protocol", "server", "integration"],
+      "coordinates_with": ["api-architect", "context-optimizer"],
+      "success_metrics": "MCP server running, tools connected",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "mobile-first",
+      "category": "framework",
+      "triggers": ["mobile", "responsive", "touch", "React Native", "Flutter"],
+      "coordinates_with": ["design-system", "perf-optimizer"],
+      "success_metrics": "mobile audit passed, responsive design",
+      "rules": [],
+      "scripts": ["mobile_audit.py"]
+    },
+    {
+      "name": "multi-agent",
+      "category": "core",
+      "triggers": ["orchestrate", "multiple agents", "coordination", "parallel", "comprehensive analysis"],
+      "coordinates_with": ["smart-router", "context-optimizer", "project-planner"],
+      "success_metrics": "agents coordinated, tasks completed",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "nextjs-pro",
+      "category": "framework",
+      "triggers": ["Next.js", "App Router", "RSC", "server actions", "SSR", "SSG"],
+      "coordinates_with": ["web-core", "react-architect"],
+      "success_metrics": "build passes, pages render",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "nodejs-pro",
+      "category": "framework",
+      "triggers": ["Node.js", "Express", "backend", "server", "API"],
+      "coordinates_with": ["api-architect", "data-modeler"],
+      "success_metrics": "server runs, no memory leaks",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "offensive-sec",
+      "category": "devops",
+      "triggers": ["pentest", "red team", "exploit", "vulnerability", "hacking"],
+      "coordinates_with": ["security-scanner", "code-review"],
+      "success_metrics": "vulnerabilities found, report complete",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "perf-optimizer",
+      "category": "devops",
+      "triggers": ["performance", "slow", "optimize", "Lighthouse", "bundle size", "Core Web Vitals"],
+      "coordinates_with": ["web-core", "feature-flags", "e2e-automation"],
+      "success_metrics": "Core Web Vitals pass, performance improved",
+      "rules": [],
+      "scripts": ["lighthouse_audit.py"]
+    },
+    {
+      "name": "project-planner",
+      "category": "core",
+      "triggers": ["plan", "breakdown", "tasks", "implementation strategy", "project scope"],
+      "coordinates_with": ["app-scaffold", "code-craft", "test-architect"],
+      "success_metrics": "plan created, tasks prioritized",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "python-pro",
+      "category": "framework",
+      "triggers": ["Python", "pip", "FastAPI", "Django", "Flask"],
+      "coordinates_with": ["test-architect", "api-architect"],
+      "success_metrics": "tests pass, type hints complete",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "react-architect",
+      "category": "architecture",
+      "triggers": ["React", "component", "hooks", "state management", "Redux", "Zustand"],
+      "coordinates_with": ["web-core", "design-system"],
+      "success_metrics": "components render, no prop drilling",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "reasoning-engine",
+      "category": "core",
+      "triggers": ["reasoning", "step-by-step", "complex problem", "analysis", "decomposition"],
+      "coordinates_with": ["creative-thinking", "project-planner", "debug-toolkit"],
+      "success_metrics": "problem solved, reasoning documented",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "review-automation",
+      "category": "devops",
+      "triggers": ["automate review", "PR check", "validate PR", "automated audit"],
+      "coordinates_with": ["code-review", "code-constitution", "git-workflow"],
+      "success_metrics": "all checks pass, no blocking issues",
+      "rules": [],
+      "scripts": ["audit_pr.js", "audit_pr.v2.js", "validate_doctrine.js"]
+    },
+    {
+      "name": "security-scanner",
+      "category": "devops",
+      "triggers": ["security", "vulnerability", "OWASP", "pentest", "threat modeling"],
+      "coordinates_with": ["code-review", "cicd-pipeline", "api-architect"],
+      "success_metrics": "no critical vulnerabilities, scan complete",
+      "rules": [],
+      "scripts": ["security_scan.py"]
+    },
+    {
+      "name": "self-evolution",
+      "category": "specialized",
+      "triggers": ["mistake", "learn", "improve", "lesson", "feedback", "wrong", "fix this"],
+      "coordinates_with": ["code-review", "code-constitution", "smart-router"],
+      "success_metrics": "lesson learned, pattern improved",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "seo-optimizer",
+      "category": "specialized",
+      "triggers": ["SEO", "meta tags", "sitemap", "search ranking", "OpenGraph"],
+      "coordinates_with": ["web-core", "perf-optimizer"],
+      "success_metrics": "SEO score improved, meta tags complete",
+      "rules": [],
+      "scripts": ["seo_checker.py"]
+    },
+    {
+      "name": "server-ops",
+      "category": "devops",
+      "triggers": ["server", "DevOps", "infrastructure", "deployment", "hosting"],
+      "coordinates_with": ["cicd-pipeline", "security-scanner"],
+      "success_metrics": "server running, uptime maintained",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "shell-script",
+      "category": "framework",
+      "triggers": ["shell", "bash", "script", "automation", "CLI"],
+      "coordinates_with": ["cicd-pipeline", "server-ops"],
+      "success_metrics": "script runs, no errors",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "skill-forge",
+      "category": "specialized",
+      "triggers": ["create skill", "new skill", "update skill", "skill development"],
+      "coordinates_with": ["project-planner", "code-craft"],
+      "success_metrics": "skill created, validated",
+      "rules": [],
+      "scripts": ["init_skill.py", "package_skill.py", "quick_validate.py"]
+    },
+    {
+      "name": "smart-router",
+      "category": "core",
+      "triggers": ["route", "select agent", "which skill", "task analysis", "multi-domain request"],
+      "coordinates_with": ["agent-modes", "context-optimizer", "multi-agent"],
+      "success_metrics": "correct skill selected, task routed",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "system-design",
+      "category": "architecture",
+      "triggers": ["architecture", "system design", "scalability", "microservices"],
+      "coordinates_with": ["api-architect", "data-modeler"],
+      "success_metrics": "architecture documented, scalability validated",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "tailwind-kit",
+      "category": "architecture",
+      "triggers": ["Tailwind", "CSS", "styling", "utility classes"],
+      "coordinates_with": ["design-system", "web-core"],
+      "success_metrics": "styles applied, design consistent",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "test-architect",
+      "category": "testing",
+      "triggers": ["test", "testing", "unit test", "coverage", "mocking", "AAA pattern"],
+      "coordinates_with": ["code-craft", "code-quality", "e2e-automation"],
+      "success_metrics": "tests pass, coverage adequate",
+      "rules": [],
+      "scripts": ["test_runner.py"]
+    },
+    {
+      "name": "test-driven-dev",
+      "category": "testing",
+      "triggers": ["TDD", "test first", "red-green-refactor"],
+      "coordinates_with": ["test-architect", "code-craft"],
+      "success_metrics": "tests written before code, coverage high",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "visual-excellence",
+      "category": "architecture",
+      "triggers": ["visual", "aesthetic", "design quality", "polish"],
+      "coordinates_with": ["design-system", "tailwind-kit"],
+      "success_metrics": "design polished, visual consistency",
+      "rules": [],
+      "scripts": []
+    },
+    {
+      "name": "web-core",
+      "category": "framework",
+      "triggers": ["React", "Next.js", "frontend", "component", "performance", "SSR", "SSG", "RSC"],
+      "coordinates_with": ["design-system", "tailwind-kit", "test-architect"],
+      "success_metrics": "Core Web Vitals pass, no performance regressions",
+      "rules": ["advanced-event-handler-refs.md", "advanced-init-once.md", "advanced-use-latest.md", "async-api-routes.md", "async-defer-await.md", "async-dependencies.md", "async-parallel.md", "async-suspense-boundaries.md", "bundle-barrel-imports.md", "bundle-conditional.md", "bundle-defer-third-party.md", "bundle-dynamic-imports.md", "bundle-preload.md", "client-event-listeners.md", "client-localstorage-schema.md", "client-passive-event-listeners.md", "client-swr-dedup.md"],
+      "scripts": []
+    }
+  ],
+  "chains": {
+    "build-web-app": {
+      "description": "Full-stack web application development workflow",
+      "skills": ["app-scaffold", "project-planner", "web-core", "design-system", "tailwind-kit", "test-architect", "code-craft"],
+      "trigger": "build app",
+      "workflows": ["/build", "/boost", "/autopilot"]
+    },
+    "security-audit": {
+      "description": "Complete security review workflow",
+      "skills": ["security-scanner", "code-review", "offensive-sec", "cicd-pipeline"],
+      "trigger": "security audit",
+      "workflows": ["/inspect"]
+    },
+    "debug-complex": {
+      "description": "Complex debugging with multiple perspectives",
+      "skills": ["debug-pro", "debug-toolkit", "reasoning-engine", "test-architect"],
+      "trigger": "deep debug",
+      "workflows": ["/diagnose"]
+    },
+    "deploy-production": {
+      "description": "Production deployment with safety checks",
+      "skills": ["cicd-pipeline", "security-scanner", "perf-optimizer", "e2e-automation", "feature-flags"],
+      "trigger": "deploy production",
+      "workflows": ["/launch"]
+    },
+    "api-development": {
+      "description": "API design and implementation workflow",
+      "skills": ["api-architect", "data-modeler", "nodejs-pro", "test-architect", "security-scanner"],
+      "trigger": "build API",
+      "workflows": ["/api"]
+    }
+  },
+  "categories": {
+    "core": {
+      "description": "Foundational skills for all development",
+      "count": 15
+    },
+    "framework": {
+      "description": "Technology-specific skills",
+      "count": 9
+    },
+    "architecture": {
+      "description": "Design and architecture patterns",
+      "count": 7
+    },
+    "devops": {
+      "description": "Deployment, security, and operations",
+      "count": 10
+    },
+    "testing": {
+      "description": "Test automation and quality assurance",
+      "count": 3
+    },
+    "specialized": {
+      "description": "Domain-specific utilities",
+      "count": 6
+    }
+  }
+}

package/.agent/config/execution-policy.json

@@ -0,0 +1,90 @@
+{
+  "$comment": "Execution Policy Schema v1.1 - Agent Skill Kit v3.3.0",
+  "version": "1.1",
+  "codebaseVersion": "3.3.0",
+  "description": "Execution policy for workflow auto-accept authorization",
+  
+  "autoAccept": {
+    "enabled": true,
+    "defaultMode": "prompt",
+    "requireAnnotation": true,
+    "requiredAnnotations": ["auto", "safe"],
+    
+    "allowPatterns": [
+      { "pattern": "^npm run [a-z0-9:-]+$", "type": "regex", "description": "npm run with safe script names" },
+      { "pattern": "^pnpm run [a-z0-9:-]+$", "type": "regex" },
+      { "pattern": "^yarn run [a-z0-9:-]+$", "type": "regex" },
+      { "pattern": "node .agent/", "type": "prefix", "description": "node scripts in .agent/" },
+      { "pattern": "node --version", "type": "exact" },
+      { "pattern": "npm --version", "type": "exact" },
+      { "pattern": "git status", "type": "exact" },
+      { "pattern": "git log", "type": "prefix" },
+      { "pattern": "git diff", "type": "prefix" },
+      { "pattern": "git branch", "type": "prefix" },
+      { "pattern": "echo ", "type": "prefix" },
+      { "pattern": "pwd", "type": "exact" },
+      { "pattern": "python --version", "type": "exact" },
+      { "pattern": "python3 --version", "type": "exact" }
+    ],
+    
+    "denyPatterns": [
+      { "pattern": "rm -rf", "type": "contains", "severity": "critical" },
+      { "pattern": "rm -r", "type": "contains", "severity": "critical" },
+      { "pattern": "rmdir /s", "type": "contains", "severity": "critical" },
+      { "pattern": "del /f", "type": "contains", "severity": "high" },
+      { "pattern": "del /s", "type": "contains", "severity": "high" },
+      { "pattern": "format", "type": "prefix", "severity": "critical" },
+      { "pattern": "shutdown", "type": "prefix", "severity": "critical" },
+      { "pattern": "git push", "type": "prefix", "severity": "high" },
+      { "pattern": "git reset --hard", "type": "contains", "severity": "critical" },
+      { "pattern": "git clean -fd", "type": "contains", "severity": "high" },
+      { "pattern": "npm publish", "type": "prefix", "severity": "high" },
+      { "pattern": "npm unpublish", "type": "prefix", "severity": "critical" },
+      { "pattern": "-e ['\"].*exec", "type": "regex", "severity": "critical", "description": "node -e with exec" },
+      { "pattern": "eval\\(", "type": "regex", "severity": "critical" },
+      { "pattern": "> /dev/null", "type": "contains", "severity": "medium" },
+      { "pattern": "| rm", "type": "contains", "severity": "critical" },
+      { "pattern": "&& rm", "type": "contains", "severity": "critical" },
+      { "pattern": "Remove-Item -Recurse", "type": "contains", "severity": "critical", "description": "PowerShell recursive delete" },
+      { "pattern": "Remove-Item -Force", "type": "contains", "severity": "high" },
+      { "pattern": "Clear-RecycleBin", "type": "prefix", "severity": "high" },
+      { "pattern": "Stop-Computer", "type": "prefix", "severity": "critical" },
+      { "pattern": "Restart-Computer", "type": "prefix", "severity": "critical" }
+    ],
+    
+    "allow": [
+      "npm run",
+      "pnpm run", 
+      "yarn run",
+      "node ",
+      "echo ",
+      "git status",
+      "git log",
+      "git diff"
+    ],
+    
+    "deny": [
+      "rm -rf",
+      "git push",
+      "npm publish"
+    ]
+  },
+  
+  "phaseGate": {
+    "requirePlanApproval": true,
+    "allowedModes": ["dry-run", "turbo", "auto-accept"]
+  },
+  
+  "annotations": {
+    "recognized": ["auto", "safe", "confirm", "ci", "readonly", "interactive"],
+    "warnOnUnknown": true,
+    "strictMode": false
+  },
+  
+  "logging": {
+    "logAutoAccept": true,
+    "logBlocked": true,
+    "logPolicyDrift": true,
+    "historyFile": ".agent/logs/execution-history.jsonl"
+  }
+}