nexa-skill-compiler 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Nexa Language Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/ouyangyipeng/Skill-Compiler/main/docs/img/nsc-logo.png" alt="NSC Logo" width="100" />
+  <h1>Nexa Skill Compiler</h1>
+  <p><b><i>Write Once, Run Anywhere for AI Agent Skills</i></b></p>
+  <p>
+    <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="License"/>
+    <img src="https://img.shields.io/badge/Version-v1.0-brightgreen.svg?style=for-the-badge" alt="Version"/>
+    <img src="https://img.shields.io/badge/Rust-1.75%2B-orange.svg?style=for-the-badge" alt="Rust"/>
+    <img src="https://img.shields.io/badge/Status-Stable-green.svg?style=for-the-badge" alt="Status"/>
+  </p>
+</div>
+
+---
+
+## Installation
+
+```bash
+# Install via npm
+npm install -g nexa-skill-compiler
+
+# Or install the Rust binary directly (recommended)
+cargo install nexa-skill-cli
+```
+
+## Quick Start
+
+```bash
+# Compile a skill for all platforms
+nsc build skill.md
+
+# Compile for specific target
+nsc build skill.md --target claude
+
+# Validate a skill file
+nsc validate skill.md
+
+# Initialize a new skill from template
+nsc init my-skill
+```
+
+## What is NSC?
+
+**Nexa Skill Compiler (NSC)** is an industrial-grade multi-target compiler that transforms unified `SKILL.md` specifications into platform-specific agent instructions.
+
+### 🔍 Frontend: Parsing & Validation
+- YAML Frontmatter Parser with type validation
+- Permission Auditor for security analysis
+- MCP Dependency Checker
+
+### 🧠 Mid-end: IR & Optimization
+- SkillIR - Platform-independent intermediate representation
+- Anti-Skill Injection - Automatic defense against dangerous behaviors
+- Security Level Analyzer with 4-tier model
+
+### 🚀 Backend: Multi-Target Emission
+- Claude Target - Claude Code compatible output
+- Codex Target - OpenAI Codex/GPT format
+- Gemini Target - Google Gemini system instructions
+
+## Performance
+
+Based on large-scale comparative experiments:
+
+| Metric | Original Skills | Compiled Skills | Improvement |
+|--------|-----------------|-----------------|-------------|
+| Avg Duration | 45.2s | 37.6s | **16.9% faster** |
+| Success Rate | 96% | 100% | +4% |
+
+## Links
+
+- 📚 [Documentation](https://github.com/ouyangyipeng/Skill-Compiler#readme)
+- 🐛 [Issue Tracker](https://github.com/ouyangyipeng/Skill-Compiler/issues)
+- 💬 [Discussions](https://github.com/ouyangyipeng/Skill-Compiler/discussions)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/bin/nsc.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Binary name based on platform
+function getBinaryName() {
+  const platform = process.platform;
+  const arch = process.arch;
+  
+  if (platform === 'win32') {
+    return 'nexa-skill.exe';
+  }
+  return 'nexa-skill';
+}
+
+// Find binary location
+function findBinary() {
+  // Check if installed via cargo
+  const cargoBin = path.join(process.env.CARGO_HOME || path.join(process.env.HOME || process.env.USERPROFILE, '.cargo', 'bin'), getBinaryName());
+  
+  // Check local node_modules
+  const localBin = path.join(__dirname, '..', 'binaries', process.platform, process.arch, getBinaryName());
+  
+  // Check PATH
+  const pathBinary = getBinaryName();
+  
+  if (fs.existsSync(cargoBin)) {
+    return cargoBin;
+  }
+  if (fs.existsSync(localBin)) {
+    return localBin;
+  }
+  
+  // Return the binary name and let the system find it in PATH
+  return pathBinary;
+}
+
+// Run the binary
+const binary = findBinary();
+const args = process.argv.slice(2);
+
+const child = spawn(binary, args, {
+  stdio: 'inherit',
+  shell: process.platform === 'win32'
+});
+
+child.on('error', (err) => {
+  if (err.code === 'ENOENT') {
+    console.error('\n\x1b[31mError: nexa-skill binary not found.\x1b[0m');
+    console.error('\nPlease install the Rust binary first:');
+    console.error('  \x1b[36mcargo install nexa-skill-cli\x1b[0m');
+    console.error('\nOr visit: https://github.com/ouyangyipeng/Skill-Compiler\n');
+    process.exit(1);
+  } else {
+    console.error('Error running nexa-skill:', err.message);
+    process.exit(1);
+  }
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "nexa-skill-compiler",
+  "version": "1.0.0",
+  "description": "Industrial-grade multi-target compiler for AI Agent Skills - Write Once, Run Anywhere",
+  "main": "index.js",
+  "bin": {
+    "nsc": "./bin/nsc.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js",
+    "test": "node test/test.js"
+  },
+  "keywords": [
+    "skill",
+    "compiler",
+    "ai",
+    "agent",
+    "claude",
+    "gpt",
+    "gemini",
+    "mcp",
+    "llm",
+    "nexa"
+  ],
+  "author": "Nexa Language Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ouyangyipeng/Skill-Compiler.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ouyangyipeng/Skill-Compiler/issues"
+  },
+  "homepage": "https://github.com/ouyangyipeng/Skill-Compiler#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+console.log('\n📦 Nexa Skill Compiler - Post Install\n');
+console.log('Checking for nexa-skill binary...');
+
+// Check if binary exists in PATH
+function binaryExists() {
+  try {
+    execSync('nexa-skill --version', { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+if (binaryExists()) {
+  console.log('✅ nexa-skill binary found in PATH.\n');
+  process.exit(0);
+}
+
+console.log('⚠️  nexa-skill binary not found in PATH.');
+console.log('\nTo complete installation, please run one of the following:\n');
+console.log('  \x1b[36m# Option 1: Install via cargo (recommended)\x1b[0m');
+console.log('  cargo install nexa-skill-cli\n');
+console.log('  \x1b[36m# Option 2: Build from source\x1b[0m');
+console.log('  git clone https://github.com/ouyangyipeng/Skill-Compiler');
+console.log('  cd Skill-Compiler');
+console.log('  cargo install --path nexa-skill-cli\n');
+console.log('📚 Documentation: https://github.com/ouyangyipeng/Skill-Compiler\n');