install-agent-skill 1.2.3

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">add-skill</h1>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/v/@dataguruin/add-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/d18m/@dataguruin/add-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?
+
+`add-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 add-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 add-agent-skill
+
+# Using pnpm
+pnpm add -g add-agent-skill
+
+# Using Yarn
+yarn global add add-agent-skill
+
+# Or run directly with npx
+npx -y add-agent-skill <command>
+```
+
+> **Requirements:** Node.js 18.0.0 or later
+
+---
+
+## Quick Start
+
+### 1. Initialize your workspace
+
+```bash
+npx -y add-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 add-agent-skill install dataguruin/coinpika-agent-skills#coinpika-pr-reviewer
+
+# Specific version
+npx -y add-agent-skill install dataguruin/coinpika-agent-skills#coinpika-doctrine-pack@v1.0.0
+```
+
+### 3. List installed skills
+
+```bash
+npx -y add-agent-skill list
+```
+
+### 4. Validate compliance
+
+```bash
+npx -y add-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 add-agent-skill lock
+
+# Install from lockfile
+npx -y add-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,271 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/add--skill-v1.2.2-000000?style=for-the-badge&logo=npm&logoColor=white" alt="add-skill v1.2.2" />
+</p>
+
+<h1 align="center">add-skill</h1>
+
+<p align="center">
+  <strong>The package manager for AI agent skills.</strong><br/>
+  Install, manage, and verify skills for Antigravity-compatible coding agents.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/v/@dataguruin/add-skill?style=flat-square&color=000000" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/dm/@dataguruin/add-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="#commands">Commands</a> •
+  <a href="#features">Features</a>
+</p>
+
+---
+
+## What is add-skill?
+
+**add-skill** is a CLI tool for managing Agent Skills—intelligent artifacts that extend your AI coding agent's capabilities.
+
+```bash
+npx -y add-agent-skill dataguruin/agent-skills
+```
+
+```
+┌   skills 
+│
+◇  Source: https://github.com/dataguruin/agent-skills.git
+│
+◆  Repository cloned
+│
+●  Found 3 skills
+│
+◆  Select skills to install
+│  ◻ coinpika-commit-formatter
+│  ◻ coinpika-doctrine-pack
+│  ◻ coinpika-pr-reviewer
+│
+◇  Installed 3 skills ──────────╮
+│                               │
+│  ✓ coinpika-commit-formatter  │
+│  ✓ coinpika-doctrine-pack     │
+│  ✓ coinpika-pr-reviewer       │
+│                               │
+├───────────────────────────────╯
+│
+└  Done!
+```
+
+Skills are **data, not code**—they're read by your agent to enhance its behavior without executing on your system.
+
+---
+
+## Installation
+
+```bash
+# Using npx (recommended)
+npx -y add-agent-skill <org/repo>
+
+# Global install
+npm install -g add-agent-skill
+
+# Or with pnpm
+pnpm add -g add-agent-skill
+```
+
+> **Requires** Node.js 18+
+
+---
+
+## Quick Start
+
+### Install skills from GitHub
+
+```bash
+npx -y add-agent-skill dataguruin/agent-skills
+```
+
+Interactive prompts let you select which skills to install.
+
+### List installed skills
+
+```bash
+npx -y add-agent-skill list
+```
+
+```
+┌   add-skill 
+│
+●  Location: ~/.agent/skills
+│
+◇  Installed Skills (3) ─────────────────────────╮
+│                                                │
+│  ✓ coinpika-commit-formatter v1.0.0 (10.1 KB)  │
+│  ✓ coinpika-doctrine-pack v1.0.0 (137.9 KB)    │
+│  ✓ coinpika-pr-reviewer v1.0.0 (9.1 KB)        │
+│                                                │
+├────────────────────────────────────────────────╯
+│
+└  Done!
+```
+
+### Check health
+
+```bash
+npx -y add-agent-skill doctor
+```
+
+```
+┌   add-skill 
+│
+◐  Running health check...
+│
+◇  Health Check Results ─────────────────────────╮
+│                                                │
+│  ✓ coinpika-commit-formatter: healthy          │
+│  ✓ coinpika-doctrine-pack: healthy             │
+│  ✓ coinpika-pr-reviewer: healthy               │
+│                                                │
+├────────────────────────────────────────────────╯
+│
+●  Errors: 0, Warnings: 0
+│
+└  Done!
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|:--------|:------------|
+| `<org/repo>` | Install skills from GitHub repository |
+| `<org/repo#skill>` | Install a specific skill |
+| `list` | List installed skills |
+| `uninstall <skill>` | Remove a skill |
+| `update <skill>` | Update to latest version |
+| `doctor` | Check integrity and health |
+| `verify` | Verify checksums |
+| `validate [skill]` | Antigravity compliance check |
+| `analyze <skill>` | Deep structure analysis |
+| `lock` | Generate `skill-lock.json` |
+| `cache info` | Show cache info |
+| `cache clear` | Clear local cache |
+| `init` | Initialize skills directory |
+
+### Flags
+
+| Flag | Description |
+|:-----|:------------|
+| `--global, -g` | Install to global scope |
+| `--yes, -y` | Skip confirmation prompts |
+| `--verbose, -v` | Show detailed output |
+| `--json` | Output as JSON |
+| `--strict` | Exit with error on violations |
+| `--fix` | Auto-fix issues where possible |
+| `--dry-run` | Preview changes without applying |
+
+---
+
+## Features
+
+### Progressive Disclosure
+
+Skills follow a structured hierarchy for efficient agent loading:
+
+```
+skill/
+├── SKILL.md              # Core instructions (always loaded)
+├── resources/            # Reference materials (on-demand)
+├── examples/             # Implementation patterns
+├── scripts/              # Helper utilities
+├── constitution/         # Governing rules
+└── doctrines/            # Behavioral policies
+```
+
+### Antigravity Compatibility Score
+
+```bash
+npx -y add-agent-skill analyze coinpika-doctrine-pack
+```
+
+```
+┌   add-skill 
+│
+●  Path: ~/.agent/skills/coinpika-doctrine-pack
+│
+◇  Skill Analysis: coinpika-doctrine-pack ───────╮
+│                                                │
+│  SKILL.md Frontmatter:                         │
+│    Name: coinpika-doctrine-pack                │
+│    Description: Constitutional governance...   │
+│    Tags: coinpika, doctrine, governance        │
+│                                                │
+│  Structure:                                    │
+│    ✓ resources                                 │
+│    ✓ examples                                  │
+│    ✓ scripts                                   │
+│    ✓ constitution                              │
+│    ✓ doctrines                                 │
+│                                                │
+│  Antigravity Score: 100/100                    │
+│                                                │
+├────────────────────────────────────────────────╯
+│
+└  Done!
+```
+
+### Security by Design
+
+| Feature | Description |
+|:--------|:------------|
+| **No Execution** | Skills are data, never executed on your system |
+| **SHA-256 Merkle Hash** | Every skill is cryptographically verified |
+| **Integrity Checks** | `doctor` and `verify` detect tampering |
+| **Audit Trail** | Full provenance tracked in `.skill-source.json` |
+| **Backups** | Automatic backup before destructive operations |
+
+---
+
+## Skill Spec Format
+
+Skills require a `SKILL.md` file with YAML frontmatter:
+
+```markdown
+---
+name: my-skill
+description: Brief description for semantic routing
+version: 1.0.0
+author: your-name
+tags: javascript, testing, react
+---
+
+# My Skill
+
+Instructions for the agent to follow...
+```
+
+---
+
+## Compatibility
+
+Works with any Antigravity-compatible coding agent:
+
+- **Gemini CLI** / **Antigravity**
+- **Claude Code**
+- **Cursor**
+- **OpenCode**
+- **Cline**
+- And more...
+
+---
+
+## 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/@dataguruin/add-skill">npm</a>
+</p>