@nebutra/next-unicorn-skill 2.0.0

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@nebutra/next-unicorn-skill",
+  "version": "2.0.0",
+  "description": "Stop Vibe Coding debt: audit your codebase, replace reinvented wheels with unicorn-grade libraries, scan vulnerabilities, auto-update deps, and auto-create PRs — all verified via Context7 MCP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "SKILL.md",
+    "templates",
+    "examples",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "skill",
+    "mcp",
+    "ai-agent",
+    "claude-code",
+    "codebase-analysis",
+    "third-party-libraries",
+    "library-recommendations",
+    "dependency-optimization",
+    "migration-planning",
+    "hand-rolled-code",
+    "code-modernization",
+    "context7",
+    "impact-scoring",
+    "ux-audit",
+    "vulnerability-scanning",
+    "auto-update",
+    "pr-automation",
+    "technical-debt",
+    "vibe-coding",
+    "monorepo"
+  ],
+  "author": "TsekaLuk (https://github.com/TsekaLuk)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TsekaLuk/Next-Unicorn-Skill.git"
+  },
+  "homepage": "https://github.com/TsekaLuk/Next-Unicorn-Skill#readme",
+  "bugs": {
+    "url": "https://github.com/TsekaLuk/Next-Unicorn-Skill/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "semver": "^7.7.4",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/semver": "^7.7.1",
+    "fast-check": "^4.4.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/templates/deletion-checklist.md

@@ -0,0 +1,42 @@
+# Deletion Checklist
+
+## Files and Code Ranges to Remove After Migration
+
+The following files and code ranges should be deleted after the corresponding migration phase is complete and verified. Always run the full test suite before and after each deletion.
+
+---
+
+| # | File Path | Line Range | Reason | Phase |
+|---|-----------|:----------:|--------|:-----:|
+{{#each migrationPlan.deletionChecklist}}
+| {{@index}} | `{{filePath}}` | {{#if lineRange}}L{{lineRange.start}}–{{lineRange.end}}{{else}}Entire file{{/if}} | {{reason}} | — |
+{{/each}}
+
+---
+
+## Estimated Impact
+
+- **Total files affected**: {{filesToDelete.length}}
+- **Estimated lines saved**: {{linesSavedEstimate}}
+
+## Deletion Procedure
+
+For each item in the checklist:
+
+- [ ] **1. Verify migration is complete** — Confirm the replacement library is fully integrated and tested
+- [ ] **2. Run test suite** — Ensure all tests pass before deletion
+- [ ] **3. Search for references** — Grep for imports/requires of the file to ensure no remaining consumers
+- [ ] **4. Delete the file or code range** — Remove the specified lines or entire file
+- [ ] **5. Run test suite again** — Confirm no regressions after deletion
+- [ ] **6. Commit with descriptive message** — Reference the migration phase and recommendation number
+
+## Safety Notes
+
+- **Never delete before migrating** — Each deletion is tied to a specific recommendation. Only delete after that recommendation's migration step is verified.
+- **Adapter strategies first** — For high-risk items with adapter strategies, the adapter must be in place and tested before the legacy code is removed.
+- **Incremental deletion** — Delete one file at a time and verify. Do not batch-delete across phases.
+- **Keep backups** — Ensure the code is committed to version control before deletion so it can be recovered if needed.
+
+---
+
+*Generated by [Next-Unicorn SKILL](../SKILL.md) — Analyze & Recommend Third-Party Optimizations*

package/templates/migration-plan.md

@@ -0,0 +1,61 @@
+# Migration Plan
+
+## Overview
+
+This document outlines the phased migration plan for replacing hand-rolled implementations with recommended third-party libraries. Phases are ordered by risk level: low-risk quick wins first, followed by medium-risk refactoring, and finally high-risk changes requiring adapter strategies.
+
+---
+
+{{#each migrationPlan.phases}}
+
+## Phase {{phase}}: {{name}}
+
+{{#each steps}}
+
+### Step {{@index}}: {{description}}
+
+- **Recommendation**: #{{recommendationIndex}}
+{{#if adapterStrategy}}
+- **Adapter Strategy Required**
+  - Wrapper Interface: `{{adapterStrategy.wrapperInterface}}`
+  - Legacy Code: `{{adapterStrategy.legacyCode}}`
+  - Target Library: `{{adapterStrategy.targetLibrary}}`
+  - Description: {{adapterStrategy.description}}
+{{/if}}
+
+{{/each}}
+
+---
+
+{{/each}}
+
+## Pre-Migration Checklist
+
+- [ ] Review all recommendations and verify they align with project goals
+- [ ] Ensure CI/CD pipeline has adequate test coverage for affected modules
+- [ ] Create feature branches for each phase
+- [ ] Set up rollback procedures for each phase
+- [ ] Communicate migration timeline to the team
+
+## Post-Migration Checklist
+
+- [ ] Run full test suite after each phase
+- [ ] Verify no regressions in affected functionality
+- [ ] Update documentation to reflect new library usage
+- [ ] Remove deprecated code per the deletion checklist
+- [ ] Update dependency lock files
+- [ ] Perform load testing if performance-critical paths were changed
+
+## Rollback Strategy
+
+If a phase introduces regressions:
+
+1. Revert the feature branch merge
+2. If an adapter strategy was used, the adapter layer provides a clean rollback point
+3. Re-run the test suite to confirm rollback is clean
+4. Investigate the regression before re-attempting the phase
+
+---
+
+*Generated by [Next-Unicorn SKILL](../SKILL.md) — Analyze & Recommend Third-Party Optimizations*
+

package/templates/prd-template.md

@@ -0,0 +1,123 @@
+# Product Requirements Document: Third-Party Library Optimization
+
+## Executive Summary
+
+This PRD presents a structured plan to replace hand-rolled implementations in **{{projectName}}** with battle-tested third-party libraries. The analysis identified **{{recommendedChanges.length}} recommendations** across **{{domains}}** domains, with an estimated **{{linesSavedEstimate}} lines of code** to be removed and a projected reduction in maintenance burden.
+
+All recommendations have been verified against real, version-correct documentation via Context7 MCP.
+
+---
+
+## Problem Statement
+
+The codebase contains custom implementations for functionality that is better served by mature, well-maintained open-source libraries. These hand-rolled solutions:
+
+- Increase maintenance burden and onboarding time
+- Lack features available in established libraries (e.g., edge cases, accessibility, i18n)
+- May contain undiscovered bugs that battle-tested libraries have already resolved
+- Prevent the team from benefiting from community-driven improvements and security patches
+
+## Proposed Solution
+
+Replace identified hand-rolled implementations with verified third-party libraries through a phased migration plan that minimizes risk and allows incremental validation.
+
+## Scope
+
+### In Scope
+
+- Library recommendations verified via Context7 MCP
+- 7-dimension impact scoring for prioritization
+- Phased migration plan with adapter strategies for high-risk changes
+- Deletion checklist with estimated lines saved
+- UX completeness audit (frontend projects)
+
+### Out of Scope
+
+- Actual code migration (this PRD provides the plan; execution is separate)
+- Vulnerability scanning of existing dependencies (use Snyk/Dependabot for that)
+- Auto-updating existing library versions (use Renovate for that)
+
+---
+
+## Recommendations Summary
+
+| # | Current Code | Recommended Library | Impact | Risk | Effort |
+|---|-------------|--------------------:|:------:|:----:|:------:|
+{{#each recommendedChanges}}
+| {{@index}} | `{{currentImplementation.filePath}}` | **{{recommendedLibrary.name}}** v{{recommendedLibrary.version}} | {{impactScores.composite}}/10 | {{migrationRisk}} | {{estimatedEffort}}h |
+{{/each}}
+
+## Impact Analysis
+
+### Quantitative Benefits
+
+- **Lines of code removed**: {{linesSavedEstimate}}
+- **Files deleted**: {{filesToDelete.length}}
+- **Average composite impact score**: {{averageCompositeScore}}/10
+
+### Qualitative Benefits
+
+- Reduced maintenance burden — community maintains the libraries
+- Improved feature coverage — libraries provide functionality beyond what was hand-rolled
+- Better security posture — libraries receive regular security audits and patches
+- Faster onboarding — new developers are more likely to know popular libraries
+- Improved test coverage — libraries come with their own test suites
+
+## Migration Plan Overview
+
+{{#each migrationPlan.phases}}
+
+### Phase {{phase}}: {{name}}
+
+- **Steps**: {{steps.length}}
+- **Risk level**: {{riskLevel}}
+- **Estimated total effort**: {{totalEffort}} developer-hours
+
+{{/each}}
+
+## UX Audit Summary
+
+| Category | Status | Recommended Library |
+|----------|:------:|--------------------:|
+{{#each uxAudit}}
+| {{category}} | {{status}} | {{#if recommendedLibrary}}{{recommendedLibrary}}{{else}}—{{/if}} |
+{{/each}}
+
+## Success Criteria
+
+- [ ] All migration phases completed without regressions
+- [ ] Test suite passes at 100% after each phase
+- [ ] Deleted code does not leave orphaned imports or dead references
+- [ ] Performance benchmarks show no degradation (or improvement)
+- [ ] Team has documented the new library usage patterns
+
+## Risks and Mitigations
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|:----------:|:------:|------------|
+| Library introduces breaking changes | Medium | High | Pin versions, use lock files, monitor changelogs |
+| Migration causes regressions | Medium | High | Phased rollout with adapter strategies, comprehensive test coverage |
+| Team unfamiliar with new library | Low | Medium | Provide documentation links, pair programming sessions |
+| License incompatibility discovered late | Low | High | Pre-filtered by license allowlist in analysis |
+| Context7 verification was unavailable | Low | Medium | Re-run verification before starting migration |
+
+## Timeline
+
+| Phase | Duration | Dependencies |
+|-------|:--------:|:------------:|
+{{#each migrationPlan.phases}}
+| Phase {{phase}}: {{name}} | {{estimatedDuration}} | {{dependencies}} |
+{{/each}}
+
+## Stakeholder Sign-Off
+
+| Role | Name | Approval | Date |
+|------|------|:--------:|:----:|
+| Engineering Lead | | ☐ | |
+| Product Manager | | ☐ | |
+| Security Lead | | ☐ | |
+| QA Lead | | ☐ | |
+
+---
+
+*Generated by [Next-Unicorn SKILL](../SKILL.md) — Analyze & Recommend Third-Party Optimizations*

package/templates/summary-table.md

@@ -0,0 +1,28 @@
+# Summary Comparison Table
+
+## Recommended Third-Party Library Replacements
+
+| # | Current Implementation | Recommended Library | Domain | Composite Score | Migration Risk | Effort (hrs) | Verification |
+|---|----------------------|--------------------:|--------|:--------------:|:--------------:|:------------:|:------------:|
+{{#each recommendedChanges}}
+| {{@index}} | `{{currentImplementation.filePath}}` (L{{currentImplementation.lineRange.start}}–{{currentImplementation.lineRange.end}}) — {{currentImplementation.patternCategory}} | **{{recommendedLibrary.name}}** v{{recommendedLibrary.version}} ({{recommendedLibrary.license}}) | {{domain}} | {{impactScores.composite}} | {{migrationRisk}} | {{estimatedEffort}} | {{verificationStatus}} |
+{{/each}}
+
+## Impact Score Breakdown
+
+| # | Library | Scalability | Performance | Security | Maintainability | Feature Richness | UX | UI Aesthetics |
+|---|---------|:-----------:|:-----------:|:--------:|:--------------:|:----------------:|:--:|:-------------:|
+{{#each recommendedChanges}}
+| {{@index}} | {{recommendedLibrary.name}} | {{impactScores.scalability}} | {{impactScores.performance}} | {{impactScores.security}} | {{impactScores.maintainability}} | {{impactScores.feature_richness}} | {{impactScores.ux}} | {{impactScores.ui_aesthetics}} |
+{{/each}}
+
+## Summary Statistics
+
+- **Total recommendations**: {{recommendedChanges.length}}
+- **Estimated lines saved**: {{linesSavedEstimate}}
+- **Files to delete**: {{filesToDelete.length}}
+- **Verified recommendations**: {{count verificationStatus "verified"}} / {{recommendedChanges.length}}
+
+---
+
+*Generated by [Next-Unicorn SKILL](../SKILL.md) — Analyze & Recommend Third-Party Optimizations*

package/templates/update-plan.md

@@ -0,0 +1,61 @@
+# Dependency Update Plan Template
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Total updates available | {{totalUpdatesAvailable}} |
+| Critical (security) | {{critical}} |
+| Urgent (deprecated/security) | {{urgent}} |
+| Recommended (new features) | {{recommended}} |
+| Routine (patches) | {{routine}} |
+| Estimated total effort | {{estimatedTotalEffort}}h |
+
+## Critical Updates (Action Required)
+
+{{#each criticalUpdates}}
+### {{packageName}}: {{currentVersion}} -> {{targetVersion}}
+
+- **Update type:** {{updateType}}
+- **Urgency:** {{urgency}}
+- **Breaking risk:** {{breakingRisk}}
+- **Vulnerabilities fixed:** {{vulnFixCount}}
+- **Estimated effort:** {{estimatedEffort}}h
+
+| Dimension | Score |
+|-----------|-------|
+| Security | {{impactScores.security}}/10 |
+| Composite | {{impactScores.composite}}/10 |
+
+{{/each}}
+
+## Grouped Updates
+
+{{#each groups}}
+### {{groupKey}} ({{items.length}} packages)
+
+**Group urgency:** {{urgency}}
+
+| Package | Current | Target | Type | Risk |
+|---------|---------|--------|------|------|
+{{#each items}}
+| {{packageName}} | {{currentVersion}} | {{targetVersion}} | {{updateType}} | {{breakingRisk}} |
+{{/each}}
+
+{{/each}}
+
+## Routine Updates
+
+{{#each routineUpdates}}
+- **{{packageName}}:** {{currentVersion}} -> {{targetVersion}} ({{updateType}}, {{estimatedEffort}}h)
+{{/each}}
+
+## Update Policy
+
+- **Strategy:** {{policy.defaultStrategy}}
+- **Min age:** {{policy.minAgeDays}} days
+- **Pinned packages:** {{#if policy.pinned}}{{policy.pinned}}{{else}}None{{/if}}
+
+---
+
+*Generated by Next-Unicorn SKILL v2.0.0*

package/templates/vuln-report.md

@@ -0,0 +1,50 @@
+# Vulnerability Report Template
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Total dependencies scanned | {{totalDepsScanned}} |
+| Current deps scanned | {{currentDepsScanned}} |
+| Recommended deps scanned | {{recommendedDepsScanned}} |
+| Critical | {{critical}} |
+| High | {{high}} |
+| Medium | {{medium}} |
+| Low | {{low}} |
+| Fixable | {{fixable}} |
+| Unfixable | {{unfixable}} |
+
+## Critical Findings
+
+{{#each criticalFindings}}
+### {{vulnerabilityId}}
+
+- **Package:** {{packageName}}@{{installedVersion}}
+- **Source:** {{source}}
+- **CVSS Score:** {{cvssScore}}
+- **Summary:** {{summary}}
+- **Fix Available:** {{#if fixAvailable}}Upgrade to {{fixAvailable}}{{else}}No fix available{{/if}}
+
+{{/each}}
+
+## High Findings
+
+{{#each highFindings}}
+### {{vulnerabilityId}}
+
+- **Package:** {{packageName}}@{{installedVersion}}
+- **Source:** {{source}}
+- **Summary:** {{summary}}
+- **Fix Available:** {{#if fixAvailable}}Upgrade to {{fixAvailable}}{{else}}No fix available{{/if}}
+
+{{/each}}
+
+## Recommended Actions
+
+1. **Immediate:** Patch all critical and high vulnerabilities with available fixes
+2. **Short-term:** Evaluate alternatives for unfixable vulnerabilities
+3. **Long-term:** Set up automated vulnerability scanning in CI/CD pipeline
+
+---
+
+*Generated by Next-Unicorn SKILL v2.0.0*