install-agent-skill 1.0.0

package/README.bigtech.md

@@ -0,0 +1,191 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/dataguruin/add-skill/main/.github/logo.svg" height="128">
+  <h1 align="center">install-agent-skill</h1>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/v/install-agent-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/d18m/install-agent-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="npm downloads"></a>
+  <a href="https://github.com/dataguruin/add-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dataguruin/add-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="license"></a>
+</p>
+
+<p align="center">
+  The enterprise-grade package manager for AI Agent Skills.<br/>
+  Designed for the <strong>Antigravity Skills</strong> specification.
+</p>
+
+<p align="center">
+  <a href="#installation">Installation</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#commands">Commands</a> •
+  <a href="#features">Features</a> •
+  <a href="#documentation">Docs</a>
+</p>
+
+---
+
+## What is add-skill?
+
+`install-agent-skill` is a CLI tool for managing **Agent Skills**—immutable, verifiable intelligence artifacts that extend your AI agent's capabilities. Think of it as `npm` for AI agents.
+
+```bash
+npx -y install-agent-skill install dataguruin/coinpika-agent-skills#coinpika-doctrine-pack
+```
+
+Skills are **data, not code**. They won't execute on your system—they're read by your agent to enhance its behavior.
+
+---
+
+## Installation
+
+```bash
+# Using npm
+npm install -g install-agent-skill
+
+# Using pnpm
+pnpm add -g install-agent-skill
+
+# Using Yarn
+yarn global add install-agent-skill
+
+# Or run directly with npx
+npx -y install-agent-skill <command>
+```
+
+> **Requirements:** Node.js 18.0.0 or later
+
+---
+
+## Quick Start
+
+### 1. Initialize your workspace
+
+```bash
+npx -y install-agent-skill init
+```
+
+This creates the `.agent/skills` directory structure in your project.
+
+### 2. Install a skill
+
+Install from GitHub with optional version pinning:
+
+```bash
+# Latest version
+npx -y install-agent-skill install dataguruin/coinpika-agent-skills#coinpika-pr-reviewer
+
+# Specific version
+npx -y install-agent-skill install dataguruin/coinpika-agent-skills#coinpika-doctrine-pack@v1.0.0
+```
+
+### 3. List installed skills
+
+```bash
+npx -y install-agent-skill list
+```
+
+### 4. Validate compliance
+
+```bash
+npx -y install-agent-skill validate
+```
+
+---
+
+## Commands
+
+| Command | Description |
+| :--- | :--- |
+| `init` | Initialize `.agent/skills` workspace |
+| `install <spec>` | Install a skill from GitHub or registry |
+| `uninstall <name>` | Remove an installed skill |
+| `update <name>` | Update a skill to latest version |
+| `upgrade-all` | Upgrade all skills in workspace |
+| `list` | List installed skills with metadata |
+| `validate` | Check Antigravity compliance |
+| `analyze <name>` | Inspect skill structure & Progressive Disclosure |
+| `doctor` | Check health & integrity |
+| `lock` | Generate `skill-lock.json` |
+| `cache clear` | Clear local cache |
+
+---
+
+## Features
+
+### Progressive Disclosure
+
+Skills follow a structured hierarchy that lets agents read only what they need:
+
+```
+skill/
+├── SKILL.md              # Core instructions (always read)
+├── resources/            # Reference materials (on-demand)
+├── examples/             # Implementation patterns (when coding)
+├── scripts/              # Helper utilities (when needed)
+├── constitution/         # Governing rules
+└── doctrines/           # Behavioral policies
+```
+
+### Deterministic Locking
+
+Pin exact versions for reproducible builds across your team:
+
+```bash
+# Generate lockfile
+npx -y install-agent-skill lock
+
+# Install from lockfile
+npx -y install-agent-skill install --locked
+```
+
+### Security by Design
+
+| Feature | Description |
+| :--- | :--- |
+| **No Execution** | Skills are data artifacts, never executed |
+| **SHA-256 Hashing** | Every skill is verified against its Merkle hash |
+| **Integrity Checks** | `doctor` command detects tampering |
+| **Audit Trail** | Full provenance tracking in `.skill-source.json` |
+
+---
+
+## Documentation
+
+<table>
+<tbody>
+<tr>
+<td><a href="https://github.com/dataguruin/add-skill/blob/main/specs/SKILL_V1.md">Skill Spec v1.0</a></td>
+<td>The Antigravity Skills specification</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dataguruin/add-skill/tree/main/examples">Examples</a></td>
+<td>Example skills and integration patterns</td>
+</tr>
+<tr>
+<td><a href="https://github.com/dataguruin/add-skill/issues">Issues</a></td>
+<td>Report bugs or request features</td>
+</tr>
+</tbody>
+</table>
+
+---
+
+## Community
+
+We welcome contributions! See our [Contributing Guide](https://github.com/dataguruin/add-skill/blob/main/CONTRIBUTING.md) to get started.
+
+<a href="https://github.com/dataguruin/add-skill/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=dataguruin/add-skill" />
+</a>
+
+---
+
+<p align="center">
+  <sub>Built with ❤️ by <a href="https://github.com/dataguruin">DataGuruIn</a></sub>
+</p>
+
+<p align="center">
+  <a href="https://github.com/dataguruin/add-skill">GitHub</a> •
+  <a href="https://www.npmjs.com/package/@dataguruin/add-skill">npm</a> •
+  <a href="https://github.com/dataguruin/add-skill/blob/main/LICENSE">License</a>
+</p>

package/README.md

@@ -0,0 +1,164 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/install--agent--skill-v1.0.0-000000?style=for-the-badge&logo=npm&logoColor=white" alt="install-agent-skill v1.0.0" />
+</p>
+
+<h1 align="center">Install Agent Skill</h1>
+
+<p align="center">
+  <strong>The enterprise standard for AI agent capability management.</strong><br/>
+  Securely install, route, and verify abilities for Antigravity-compatible coding agents.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/v/install-agent-skill?style=flat-square&color=000000" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/dm/install-agent-skill?style=flat-square&color=000000" alt="npm downloads"></a>
+  <a href="https://github.com/dataguruin/add-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dataguruin/add-skill?style=flat-square&color=000000" alt="license"></a>
+</p>
+
+<p align="center">
+  <a href="#installation">Installation</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#workflow">Workflow</a> •
+  <a href="#architecture">Architecture</a>
+</p>
+
+---
+
+## Overview
+
+**Install Agent Skill** is a production-grade CLI for orchestrating **Agent Skills**—modular, verifiable capability packs that extend AI agents without executing arbitrary code. It treats agent capabilities as managed dependencies, ensuring reproducibility and security across your engineering organization.
+
+### Key Value Proposition
+*   **Zero-Execution Integrity**: Skills are data, not scripts. No unauthorized code runs on your machine.
+*   **Single Source of Truth**: 'Smart Symlinks' keep your projects in sync with a central global registry.
+*   **Semantic Routing**: Automatically maps skills to the agents best suited to execute them.
+
+---
+
+## Installation
+
+```bash
+# Zero-setup execution (Recommended)
+npx -y install-agent-skill dataguruin/agent-skills
+```
+
+```bash
+# Global installation
+npm install -g install-agent-skill
+```
+
+> **System Requirements**
+> *   Node.js 18.0.0 or higher
+> *   Windows / macOS / Linux
+
+---
+
+## Workflow
+
+### 1. Interactive Installation
+The CLI guides you through skill selection, agent targeting, and installation method.
+
+```bash
+npx -y install-agent-skill dataguruin/agent-skills
+```
+
+```text
+┌   Install Agent Skill v1.0.0 
+│
+◇  Source: https://github.com/dataguruin/agent-skills.git
+◇  Repository cloned 
+│
+◇  Found 3 skills
+│
+◆  Select skills to install
+│
+◆  (Press <space> to select, <enter> to submit)
+│  ◼ coinpika-doctrine-pack (>...)
+│  ◻ coinpika-commit-formatter (>...)
+│
+◆  Select agents to install skills to (Antigravity only)
+│  ◼ Antigravity (.agent/skills)
+│
+◇  Installation scope
+│  Project
+│
+◆  Installation method
+│  ● Symlink (Recommended) (Single source of truth, easy updates)
+│  ○ Copy to all agents
+│
+◇  Installation Summary
+│
+│  ╭ Installation Summary ───────────────────────────────────────────╮
+│  │                                                                 │
+│  │   ~\Desktop\New Project\.agents\skills\coinpika-doctrine-pack   │
+│  │     symlink → Antigravity                                       │
+│  │                                                                 │
+│  ╰─────────────────────────────────────────────────────────────────╯
+│
+◆  Proceed with installation?
+│  Yes
+│
+◇  Installation complete
+│
+│  ╭ Installed 1 skills to 1 agents ─────────────────────────────────╮
+│  │                                                                 │
+│  │   ✓ ~\Desktop\New Project\.agents\skills\coinpika-doctrine-pack │
+│  │     symlink → Antigravity                                       │
+│  │                                                                 │
+│  ╰─────────────────────────────────────────────────────────────────╯
+│
+└  Done!
+```
+
+### 2. Choose Your Strategy
+We offer two robust installation strategies tailored to your workflow:
+
+#### 🔗 Symlink (Recommended)
+*   **Mechanism**: Uses `fs.symlink` (Junctions on Windows) to link your project's skill folder to a persistent global storage (`~/.gemini/antigravity/skills/storage`).
+*   **Benefit**: **Single Source of Truth**. Updating the skill once in global storage updates it across all your projects instantly. Ideal for core doctrines and standardized team rules.
+
+#### 📋 Copy
+*   **Mechanism**: Performs a deep copy of the skill files into your project.
+*   **Benefit**: **Isolation**. Perfect for project-specific customization where you need to modify the skill without affecting other projects.
+
+---
+
+## Architecture
+
+### Progressive Disclosure
+To prevent context window overflow, skills use a hierarchical loading system:
+
+| Layer | Component | Description | Load Trigger |
+|:------|:----------|:------------|:-------------|
+| **L1** | `SKILL.md` | Core directives & metadata | Always Active |
+| **L2** | `doctrines/` | Specific behavioral policies | Context-Sensitive |
+| **L3** | `resources/` | Deep documentation & specs | On-Demand |
+
+### Security & Verification
+Your security is our priority.
+*   **Merkle Hashing**: Every installed skill is fingerprinted (`SHA-256`) and stored in `.skill-source.json`.
+*   **Tamper Detection**: Run `install-agent-skill doctor` to verify that no files have been modified since installation.
+
+---
+
+## Commands
+
+| Command | Usage |
+|:--------|:------|
+| `install <repo>` | Interactive wizard to install skills from GitHub. |
+| `list` | View installed skills, versions, and health status. |
+| `doctor` | Diagnose configuration and integrity issues. |
+| `verify` | Cryptographically verify installed assets against their manifest. |
+| `analyze <skill>` | Inspect a skill's compatibility score and structure. |
+| `uninstall <skill>` | Remove a skill and clean up symlinks/artifacts. |
+
+---
+
+## License
+
+MIT © [DataGuruIn](https://github.com/dataguruin)
+
+<p align="center">
+  <a href="https://github.com/dataguruin/add-skill">GitHub</a> •
+  <a href="https://www.npmjs.com/package/install-agent-skill">npm</a>
+</p>

package/bin/add-skill.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * DEPRECATED: Use bin/cli.js instead
+ */
+import "./cli.js";

package/bin/add-skill.modular.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * DEPRECATED: Use bin/cli.js instead
+ */
+import "./cli.js";