pikakit 1.0.0

package/README.md

@@ -0,0 +1,239 @@
+# PikaKit
+
+> **CLI installer for Agent Skill Kit - FAANG-grade AI skills, workflows, and agents**
+
+[![npm](https://img.shields.io/badge/npm-pikakit-CB3837?style=flat&logo=npm)](https://www.npmjs.com/package/pikakit)
+[![version](https://img.shields.io/badge/version-1.0.0-7c3aed?style=flat&colorA=18181b)](https://www.npmjs.com/package/pikakit)
+[![JavaScript](https://img.shields.io/badge/100%25-JavaScript-F7DF1E?style=flat&colorA=18181b&logo=javascript)](https://github.com/agentskillkit/pikakit)
+[![license](https://img.shields.io/badge/license-MIT-7c3aed?style=flat&colorA=18181b)](LICENSE)
+
+---
+
+## ⚡ Installation
+
+```bash
+npx -y pikakit agentskillkit/agent-skills
+```
+
+**That's it!** One command installs everything:
+
+| Component | Count | Description |
+|-----------|-------|-------------|
+| **Skills** | 49 | FAANG-grade coding skills |
+| **Workflows** | 26 | `/think`, `/build`, `/autopilot`, etc. |
+| **Agents** | 25 | Specialist AI agents |
+| **Rules** | GEMINI.md | AI behavior configuration |
+| **Scripts** | 25 | JavaScript automation scripts |
+| **Commands** | `kit` | CLI management tool |
+| **Commands** | `agent` | Interactive learning (optional) |
+
+---
+
+## 🎯 What This CLI Does
+
+### 1. Fetches Skills from GitHub
+
+```bash
+npx -y pikakit <owner>/<repo>
+
+# Examples:
+npx pikakit agentskillkit/agent-skills     # Official skills
+npx pikakit myteam/company-skills          # Custom skills
+```
+
+### 2. Interactive Installation
+
+```
+┌───────────────────────────────────────────┐
+│   🛠️  Agent Skill Kit Installer          │
+├───────────────────────────────────────────┤
+│   ◆  Select skills to install            │
+│   ◆  Choose install scope                │
+│   ◆  Configure AutoLearn (optional)      │
+│   ◆  Auto-install dependencies           │
+└───────────────────────────────────────────┘
+```
+
+### 3. Creates Ready-to-Use Structure
+
+```
+your-project/
+├── .agent/
+│   ├── GEMINI.md              # AI Rules
+│   ├── skills/                # 49 Skills
+│   ├── workflows/             # 26 Workflows
+│   ├── agents/                # 25 Agents
+│   ├── knowledge/             # Learning memory
+│   ├── config/                # Configuration
+│   ├── scripts-js/            # Automation
+│   └── metrics/               # Tracking
+│
+├── kit.cmd / kit              # CLI wrapper
+└── agent.cmd / agent          # AutoLearn (optional)
+```
+
+---
+
+## 🔧 CLI Options
+
+### Install Scope
+
+| Option | Location | Best For |
+|--------|----------|----------|
+| **Project** | `.agent/` in current project | Single project |
+| **Global** | `~/.gemini/antigravity/` | All projects |
+
+### AutoLearn (Optional)
+
+When prompted "Install AutoLearn?":
+
+| Choice | Effect |
+|--------|--------|
+| **Yes** | Installs `agent` command for interactive learning |
+| **No** | Core functionality works perfectly, just no `agent` CLI |
+
+> **Note:** Choosing "No" does NOT affect workflows, skills, or agents.
+
+---
+
+## 📦 Commands After Installation
+
+### `kit` Command (Always Available)
+
+```bash
+kit list                    # List all installed skills
+kit validate                # Validate skill structure  
+kit info <skill>            # Show skill details
+kit doctor                  # Check system health
+kit cache status            # View cache usage
+kit cache clear             # Clear cache
+```
+
+### `agent` Command (If AutoLearn Installed)
+
+```bash
+agent                       # Launch dashboard
+agent learn                 # Teach patterns
+agent recall                # Scan violations
+agent stats                 # View statistics
+agent watch                 # Real-time monitor
+```
+
+---
+
+## 🚀 Usage Examples
+
+### Install Official Skills
+
+```bash
+npx -y pikakit agentskillkit/agent-skills
+```
+
+### Install to Global Location
+
+```bash
+npx -y pikakit agentskillkit/agent-skills --global
+```
+
+### Force Reinstall
+
+```bash
+npx -y pikakit agentskillkit/agent-skills --force
+```
+
+---
+
+## 🗂️ What Gets Installed
+
+### Complete Structure
+
+```
+.agent/
+├── GEMINI.md                      # Supreme AI Rules
+├── ARCHITECTURE.md                # System Overview
+├── CONTINUOUS_EXECUTION_POLICY.md # Autopilot Rules
+├── WORKFLOW_CHAINS.md             # Workflow Patterns
+│
+├── skills/                        # 49 Skills
+│   ├── auto-learner/
+│   ├── react-architect/
+│   ├── typescript-expert/
+│   ├── debug-pro/
+│   ├── studio/
+│   └── ... (44 more)
+│
+├── workflows/                     # 26 Workflows
+│   ├── think.md
+│   ├── build.md
+│   ├── autopilot.md
+│   └── ... (23 more)
+│
+├── agents/                        # 25 Agents
+│   ├── frontend-specialist.md
+│   ├── backend-specialist.md
+│   └── ... (23 more)
+│
+├── knowledge/                     # Learning Memory
+│   └── lessons-learned.yaml
+│
+├── config/                        # Configuration
+├── scripts-js/                    # 25 JS Scripts
+└── metrics/                       # Performance
+```
+
+### Dependencies Auto-Installed
+
+```bash
+npm install                        # Node.js dependencies
+```
+
+---
+
+## 🔗 Related Packages
+
+| Package | Purpose |
+|---------|---------|
+| [agent-skills](https://github.com/agentskillkit/agent-skills) | Main skills repository |
+| [pikakit](https://www.npmjs.com/package/pikakit) | This CLI installer |
+
+---
+
+## 📈 Version History
+
+**v1.0.0 (Current)**
+- ✅ Renamed to PikaKit for cross-platform npx support
+- ✅ Works with `npx pikakit` on Windows, macOS, Linux
+- ✅ 100% JavaScript - No Python required
+- ✅ AutoLearn made optional
+- ✅ Complete installation (config, scripts-js, metrics, policy docs)
+
+---
+
+## 🛠️ Development
+
+```bash
+# Clone
+git clone https://github.com/agentskillkit/pikakit.git
+cd pikakit
+
+# Install dependencies
+npm install
+
+# Run locally
+node bin/cli.mjs install agentskillkit/agent-skills
+```
+
+---
+
+## 📄 License
+
+MIT - Free for all projects.
+
+---
+
+**⚡ PikaKit v1.0.0**
+*One command. Complete AI setup.*
+
+---
+
+**[GitHub](https://github.com/agentskillkit/pikakit) • [npm](https://www.npmjs.com/package/pikakit) • [Issues](https://github.com/agentskillkit/pikakit/issues)**

package/bin/add-skill-kit.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// CJS wrapper for ESM module - enables npx compatibility on Windows
+import('./kit.js');

package/bin/cli.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Agent Skill Kit CLI - Main Entry Point
+ * Using .mjs extension for Windows npx compatibility
+ */
+import('./kit.mjs');

package/bin/kit.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * Install Agent Skill CLI
+ * @description Package manager for AI Agent Skills
+ */
+import { c, brandedIntro } from "./lib/ui.js";
+import { command, params, VERSION } from "./lib/config.js";
+
+// --- Command Registry ---
+const COMMANDS = {
+    // Installation
+    install: { module: "./lib/commands/install.js", hasParam: true, aliases: ["add", "i"] },
+    uninstall: { module: "./lib/commands/uninstall.js", hasParam: true, aliases: ["remove", "rm"] },
+    update: { module: "./lib/commands/update.js", hasParam: true },
+
+    // Workspace
+    init: { module: "./lib/commands/init.js", aliases: ["list", "ls"] },
+    lock: { module: "./lib/commands/lock.js" },
+    cache: { module: "./lib/commands/cache.js", hasParam: true },
+
+    // Validation
+    verify: { module: "./lib/commands/verify.js" },
+    doctor: { module: "./lib/commands/doctor.js" },
+    validate: { module: "./lib/commands/validate.js", hasParam: true, aliases: ["check"] },
+    analyze: { module: "./lib/commands/analyze.js", hasParam: true },
+
+    // Info
+    info: { module: "./lib/commands/info.js", hasParam: true, aliases: ["show"] },
+    help: { module: "./lib/commands/help.js", aliases: ["--help", "-h"] }
+};
+
+/**
+ * Find command config by name or alias
+ * @param {string} cmd - Command name or alias
+ * @returns {{ name: string, config: object } | null}
+ */
+function findCommand(cmd) {
+    // Direct match
+    if (COMMANDS[cmd]) {
+        return { name: cmd, config: COMMANDS[cmd] };
+    }
+
+    // Alias match
+    for (const [name, config] of Object.entries(COMMANDS)) {
+        if (config.aliases?.includes(cmd)) {
+            return { name, config };
+        }
+    }
+
+    return null;
+}
+
+// --- MAIN ---
+async function main() {
+    brandedIntro(VERSION);
+
+    try {
+        // Handle version flag
+        if (command === "--version" || command === "-V") {
+            console.log(VERSION);
+            return;
+        }
+
+        // Find command
+        const found = findCommand(command);
+
+        if (found) {
+            const cmdModule = await import(found.config.module);
+            await cmdModule.run(found.config.hasParam ? params[0] : undefined);
+        } else if (command.includes("/")) {
+            // Direct install via org/repo syntax
+            const cmdModule = await import("./lib/commands/install.js");
+            await cmdModule.run(command);
+        } else {
+            console.log(`Unknown command: ${command}`);
+            const cmdModule = await import("./lib/commands/help.js");
+            await cmdModule.run();
+        }
+    } catch (err) {
+        console.error(c.red("\nError: " + err.message));
+        if (process.env.DEBUG) console.error(err.stack);
+        process.exit(1);
+    }
+}
+
+main().catch(err => {
+    console.error(c.red("\nFatal Error: " + err.message));
+    process.exit(1);
+});

package/bin/lib/agents.js

@@ -0,0 +1,208 @@
+/**
+ * @fileoverview Agent definitions and detection
+ * Based on Vercel's agent-skills CLI structure
+ */
+
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+const home = homedir();
+
+// Environment-based paths
+const codexHome = process.env.CODEX_HOME?.trim() || join(home, ".codex");
+const claudeHome = process.env.CLAUDE_CONFIG_DIR?.trim() || join(home, ".claude");
+
+/**
+ * @typedef {Object} AgentConfig
+ * @property {string} name - Internal agent ID
+ * @property {string} displayName - Display name for UI
+ * @property {string} skillsDir - Project-level skills directory
+ * @property {string} globalSkillsDir - Global skills directory
+ * @property {() => boolean} detect - Detection function
+ */
+
+/**
+ * All supported agents with detection logic
+ * @type {Record<string, AgentConfig>}
+ */
+export const AGENTS = {
+    antigravity: {
+        name: "antigravity",
+        displayName: "Antigravity",
+        skillsDir: ".agent/skills",
+        globalSkillsDir: join(home, ".gemini/antigravity/global_skills"),
+        detect: () => existsSync(join(process.cwd(), ".agent")) || existsSync(join(home, ".gemini/antigravity"))
+    },
+    "claude-code": {
+        name: "claude-code",
+        displayName: "Claude Code",
+        skillsDir: ".claude/skills",
+        globalSkillsDir: join(claudeHome, "skills"),
+        detect: () => existsSync(claudeHome)
+    },
+    codex: {
+        name: "codex",
+        displayName: "Codex",
+        skillsDir: ".codex/skills",
+        globalSkillsDir: join(codexHome, "skills"),
+        detect: () => existsSync(codexHome) || existsSync("/etc/codex")
+    },
+    "gemini-cli": {
+        name: "gemini-cli",
+        displayName: "Gemini CLI",
+        skillsDir: ".gemini/skills",
+        globalSkillsDir: join(home, ".gemini/skills"),
+        detect: () => existsSync(join(home, ".gemini"))
+    },
+    "github-copilot": {
+        name: "github-copilot",
+        displayName: "GitHub Copilot",
+        skillsDir: ".github/skills",
+        globalSkillsDir: join(home, ".copilot/skills"),
+        detect: () => existsSync(join(process.cwd(), ".github")) || existsSync(join(home, ".copilot"))
+    },
+    windsurf: {
+        name: "windsurf",
+        displayName: "Windsurf",
+        skillsDir: ".windsurf/skills",
+        globalSkillsDir: join(home, ".codeium/windsurf/skills"),
+        detect: () => existsSync(join(home, ".codeium/windsurf"))
+    },
+    cursor: {
+        name: "cursor",
+        displayName: "Cursor",
+        skillsDir: ".cursor/skills",
+        globalSkillsDir: join(home, ".cursor/skills"),
+        detect: () => existsSync(join(home, ".cursor"))
+    },
+    cline: {
+        name: "cline",
+        displayName: "Cline",
+        skillsDir: ".cline/skills",
+        globalSkillsDir: join(home, ".cline/skills"),
+        detect: () => existsSync(join(home, ".cline"))
+    },
+    roo: {
+        name: "roo",
+        displayName: "Roo Code",
+        skillsDir: ".roo/skills",
+        globalSkillsDir: join(home, ".roo/skills"),
+        detect: () => existsSync(join(home, ".roo"))
+    },
+    continue: {
+        name: "continue",
+        displayName: "Continue",
+        skillsDir: ".continue/skills",
+        globalSkillsDir: join(home, ".continue/skills"),
+        detect: () => existsSync(join(process.cwd(), ".continue")) || existsSync(join(home, ".continue"))
+    },
+    goose: {
+        name: "goose",
+        displayName: "Goose",
+        skillsDir: ".goose/skills",
+        globalSkillsDir: join(home, ".config/goose/skills"),
+        detect: () => existsSync(join(home, ".config/goose"))
+    },
+    trae: {
+        name: "trae",
+        displayName: "Trae",
+        skillsDir: ".trae/skills",
+        globalSkillsDir: join(home, ".trae/skills"),
+        detect: () => existsSync(join(home, ".trae"))
+    },
+    kilo: {
+        name: "kilo",
+        displayName: "Kilo Code",
+        skillsDir: ".kilocode/skills",
+        globalSkillsDir: join(home, ".kilocode/skills"),
+        detect: () => existsSync(join(home, ".kilocode"))
+    },
+    opencode: {
+        name: "opencode",
+        displayName: "OpenCode",
+        skillsDir: ".opencode/skills",
+        globalSkillsDir: join(home, ".config/opencode/skills"),
+        detect: () => existsSync(join(home, ".config/opencode"))
+    },
+    amp: {
+        name: "amp",
+        displayName: "Amp",
+        skillsDir: ".agents/skills",
+        globalSkillsDir: join(home, ".config/agents/skills"),
+        detect: () => existsSync(join(home, ".config/amp"))
+    },
+    junie: {
+        name: "junie",
+        displayName: "Junie",
+        skillsDir: ".junie/skills",
+        globalSkillsDir: join(home, ".junie/skills"),
+        detect: () => existsSync(join(home, ".junie"))
+    },
+    "kiro-cli": {
+        name: "kiro-cli",
+        displayName: "Kiro CLI",
+        skillsDir: ".kiro/skills",
+        globalSkillsDir: join(home, ".kiro/skills"),
+        detect: () => existsSync(join(home, ".kiro"))
+    },
+    zencoder: {
+        name: "zencoder",
+        displayName: "Zencoder",
+        skillsDir: ".zencoder/skills",
+        globalSkillsDir: join(home, ".zencoder/skills"),
+        detect: () => existsSync(join(home, ".zencoder"))
+    },
+    openhands: {
+        name: "openhands",
+        displayName: "OpenHands",
+        skillsDir: ".openhands/skills",
+        globalSkillsDir: join(home, ".openhands/skills"),
+        detect: () => existsSync(join(home, ".openhands"))
+    },
+    "qwen-code": {
+        name: "qwen-code",
+        displayName: "Qwen Code",
+        skillsDir: ".qwen/skills",
+        globalSkillsDir: join(home, ".qwen/skills"),
+        detect: () => existsSync(join(home, ".qwen"))
+    }
+};
+
+/**
+ * Detect all installed agents on the system
+ * @returns {Array<{name: string, displayName: string, skillsDir: string, globalSkillsDir: string}>}
+ */
+export function detectInstalledAgents() {
+    const detected = [];
+
+    for (const [key, config] of Object.entries(AGENTS)) {
+        if (config.detect()) {
+            detected.push({
+                name: config.name,
+                displayName: config.displayName,
+                skillsDir: config.skillsDir,
+                globalSkillsDir: config.globalSkillsDir
+            });
+        }
+    }
+
+    return detected;
+}
+
+/**
+ * Get agent config by name
+ * @param {string} name - Agent name
+ * @returns {AgentConfig | undefined}
+ */
+export function getAgentConfig(name) {
+    return AGENTS[name];
+}
+
+/**
+ * Get all agent names
+ * @returns {string[]}
+ */
+export function getAllAgentNames() {
+    return Object.keys(AGENTS);
+}

package/bin/lib/commands/analyze.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Analyze command - Skill structure analysis
+ */
+
+import fs from "fs";
+import path from "path";
+import { resolveScope, getDirSize } from "../helpers.js";
+import { parseSkillMdFrontmatter, detectSkillStructure } from "../skills.js";
+import { step, stepLine, S, c, fatal } from "../ui.js";
+
+/**
+ * Analyze skill structure
+ * @param {string} skillName - Skill to analyze
+ */
+export async function run(skillName) {
+    if (!skillName) fatal("Missing skill name");
+
+    const scope = resolveScope();
+    const skillDir = path.join(scope, skillName);
+
+    if (!fs.existsSync(skillDir)) fatal(`Skill not found: ${skillName}`);
+
+    stepLine();
+    step(c.bold(`Skill Analysis: ${skillName}`), S.diamondFilled, "cyan");
+    console.log(`${c.gray(S.branch)}  ${c.dim("Path: " + skillDir)}`);
+    stepLine();
+
+    // SKILL.md frontmatter
+    const smp = path.join(skillDir, "SKILL.md");
+    if (fs.existsSync(smp)) {
+        const m = parseSkillMdFrontmatter(smp);
+        console.log(`${c.gray(S.branch)}  ${c.cyan("SKILL.md Frontmatter:")}`);
+        console.log(`${c.gray(S.branch)}    Name: ${m.name || c.dim("(not set)")}`);
+        console.log(`${c.gray(S.branch)}    Description: ${m.description ? m.description.substring(0, 60) : c.red("(MISSING)")}`);
+        if (m.tags) console.log(`${c.gray(S.branch)}    Tags: ${m.tags.join(", ")}`);
+        stepLine();
+    }
+
+    // Structure
+    const structure = detectSkillStructure(skillDir);
+    console.log(`${c.gray(S.branch)}  ${c.cyan("Structure:")}`);
+
+    const items = [
+        ["resources", structure.hasResources],
+        ["examples", structure.hasExamples],
+        ["scripts", structure.hasScripts],
+        ["constitution", structure.hasConstitution],
+        ["doctrines", structure.hasDoctrines]
+    ];
+
+    items.forEach(([n, has]) => {
+        console.log(`${c.gray(S.branch)}    ${has ? c.green(S.check) : c.dim("â—‹")} ${has ? c.bold(n) : c.dim(n)}`);
+    });
+
+    stepLine();
+
+    // Antigravity Score
+    let score = 0;
+    if (fs.existsSync(smp)) score += 20;
+    const m = parseSkillMdFrontmatter(smp);
+    if (m.description) score += 25;
+    if (m.tags && m.tags.length > 0) score += 10;
+    if (structure.hasResources || structure.hasExamples || structure.hasScripts) score += 20;
+    if (fs.existsSync(path.join(skillDir, ".skill-source.json"))) score += 10;
+    if (structure.hasConstitution || structure.hasDoctrines) score += 15;
+
+    const scoreColor = score >= 80 ? c.green : score >= 50 ? c.yellow : c.red;
+    console.log(`${c.gray(S.branch)}  ${c.cyan("Antigravity Score:")} ${scoreColor(score + "/100")}`);
+    stepLine();
+}

package/bin/lib/commands/cache.js

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Cache command
+ */
+
+import fs from "fs";
+import { step, stepLine, S, c, fatal, success } from "../ui.js";
+import { getDirSize, formatBytes, listBackups } from "../helpers.js";
+import { CACHE_ROOT, REGISTRY_CACHE, BACKUP_DIR, DRY } from "../config.js";
+
+/**
+ * Manage cache
+ * @param {string} [sub] - Subcommand: info, clear, backups
+ */
+export async function run(sub) {
+    stepLine();
+
+    if (sub === "clear") {
+        if (DRY) {
+            step(`Would clear: ${CACHE_ROOT}`, S.diamond);
+            return;
+        }
+        if (fs.existsSync(CACHE_ROOT)) {
+            const size = getDirSize(CACHE_ROOT);
+            fs.rmSync(CACHE_ROOT, { recursive: true, force: true });
+            success(`Cache cleared (${formatBytes(size)})`);
+        } else {
+            step("Cache already empty", S.diamond);
+        }
+        return;
+    }
+
+    if (sub === "info" || !sub) {
+        if (!fs.existsSync(CACHE_ROOT)) {
+            step("Cache is empty", S.diamond);
+            return;
+        }
+
+        const rs = fs.existsSync(REGISTRY_CACHE) ? getDirSize(REGISTRY_CACHE) : 0;
+        const bs = fs.existsSync(BACKUP_DIR) ? getDirSize(BACKUP_DIR) : 0;
+
+        step(c.bold("Cache Info"), S.diamondFilled, "cyan");
+        console.log(`${c.gray(S.branch)}  Location: ${CACHE_ROOT}`);
+        console.log(`${c.gray(S.branch)}  Registries: ${formatBytes(rs)}`);
+        console.log(`${c.gray(S.branch)}  Backups: ${formatBytes(bs)}`);
+        console.log(`${c.gray(S.branch)}  Total: ${formatBytes(getDirSize(CACHE_ROOT))}`);
+        stepLine();
+        return;
+    }
+
+    if (sub === "backups") {
+        const backups = listBackups();
+        if (backups.length === 0) {
+            step("No backups found", S.diamond);
+            return;
+        }
+
+        step(c.bold("Backups"), S.diamondFilled, "cyan");
+        stepLine();
+        backups.forEach(b => console.log(`${c.gray(S.branch)}  ${b.name} (${formatBytes(b.size)})`));
+        stepLine();
+        return;
+    }
+
+    fatal(`Unknown cache subcommand: ${sub}`);
+}