skillkit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rohit Ghumare
+
+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,308 @@
+# SkillKit
+
+Universal skills loader for AI coding agents. Install, manage, and sync skills across your favorite AI tools.
+
+Skills follow the [Agent Skills](https://agentskills.io) open format—a simple, portable standard for giving agents new capabilities and expertise.
+
+### Compatible With
+
+| Agent | Status |
+|-------|--------|
+| Claude Code | ✅ Native |
+| OpenAI Codex | ✅ Native |
+| Cursor | ✅ Native |
+| Gemini CLI | ✅ Native |
+| OpenCode | ✅ Native |
+| Amp | ✅ Supported |
+| Goose | ✅ Supported |
+| VS Code (Copilot) | ✅ Supported |
+| Letta | ✅ Supported |
+| Factory | ✅ Supported |
+| Antigravity | ✅ Native |
+| *Any markdown-config agent* | ✅ Universal |
+
+## Features
+
+- **Multi-Agent Support**: Works with 10+ AI coding agents out of the box
+- **Multi-Platform Git**: GitHub, GitLab, Bitbucket, and local paths
+- **CI/CD Friendly**: Non-interactive flags for automation (`--skills`, `--all`, `--yes`)
+- **Skill Toggle**: Enable/disable skills without removing them
+- **Type-Safe**: Built with TypeScript and Zod validation
+- **Zero Config**: Auto-detects your agent and configures appropriately
+
+## Installation
+
+```bash
+npm install -g skillkit
+# or
+npx skillkit <command>
+```
+
+## Quick Start
+
+```bash
+# Initialize in your project (auto-detects agent)
+skillkit init
+
+# Install skills from GitHub
+skillkit install owner/repo
+
+# Install from GitLab
+skillkit install gitlab:owner/repo
+
+# Install specific skills (CI/CD friendly)
+skillkit install owner/repo --skills=pdf,xlsx,docx
+
+# Sync skills to your agent config
+skillkit sync
+
+# Read a skill (for AI consumption)
+skillkit read pdf
+```
+
+## Popular Skill Repositories
+
+Install skills from these community repositories:
+
+```bash
+# Anthropic's official skill marketplace
+skillkit install anthropics/skills
+
+# Vercel's React & Next.js best practices
+skillkit install vercel-labs/agent-skills/skills
+```
+
+| Repository | Skills | Description |
+|------------|--------|-------------|
+| [anthropics/skills](https://github.com/anthropics/skills) | `pdf`, `xlsx`, `docx`, etc. | Official Claude Code skill marketplace |
+| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | `vercel-react-best-practices`, `web-design-guidelines` | React/Next.js optimization & UI review |
+
+
+## Commands
+
+### `skillkit install <source>`
+
+Install skills from various sources.
+
+```bash
+# GitHub (default)
+skillkit install owner/repo
+skillkit install https://github.com/owner/repo
+
+# Install from a subdirectory
+skillkit install owner/repo/skills
+
+# GitLab
+skillkit install gitlab:owner/repo
+skillkit install https://gitlab.com/owner/repo
+
+# Bitbucket
+skillkit install bitbucket:owner/repo
+
+# Local path
+skillkit install ./my-skills
+skillkit install ~/dev/skills
+
+# Options
+--skills=pdf,xlsx    # Install specific skills only (CI/CD)
+--all                # Install all discovered skills
+--yes                # Skip confirmation prompts
+--global             # Install to global directory
+--force              # Overwrite existing skills
+--provider=gitlab    # Force specific provider
+```
+
+### `skillkit sync`
+
+Sync installed skills to your agent's config file.
+
+```bash
+skillkit sync
+skillkit sync --agent cursor
+skillkit sync --output AGENTS.md
+skillkit sync --enabled-only
+```
+
+### `skillkit read <skills>`
+
+Read skill content for AI agent consumption.
+
+```bash
+skillkit read pdf
+skillkit read pdf,xlsx,docx    # Multiple skills
+```
+
+### `skillkit list`
+
+List all installed skills.
+
+```bash
+skillkit list
+skillkit list --enabled
+skillkit list --json
+```
+
+### `skillkit enable/disable <skills>`
+
+Toggle skills on/off without removing them.
+
+```bash
+skillkit enable pdf xlsx
+skillkit disable docx
+```
+
+### `skillkit update [skills]`
+
+Update skills from their original sources.
+
+```bash
+skillkit update          # Update all
+skillkit update pdf xlsx # Update specific
+```
+
+### `skillkit remove <skills>`
+
+Remove installed skills.
+
+```bash
+skillkit remove pdf xlsx
+```
+
+### `skillkit init`
+
+Initialize skillkit in a project.
+
+```bash
+skillkit init
+skillkit init --agent cursor
+skillkit init --list    # List supported agents
+```
+
+### `skillkit validate <path>`
+
+Validate skills against the [Agent Skills specification](https://agentskills.io/specification).
+
+```bash
+skillkit validate ./my-skill        # Validate single skill
+skillkit validate ./skills --all    # Validate all skills in directory
+```
+
+## Supported Agents
+
+| Agent | Config File | Skills Directory |
+|-------|-------------|------------------|
+| Claude Code | `AGENTS.md` | `.claude/skills/` |
+| Cursor | `.cursorrules` | `.cursor/skills/` |
+| Codex | `AGENTS.md` | `.codex/skills/` |
+| Gemini CLI | `GEMINI.md` | `.gemini/skills/` |
+| OpenCode | `AGENTS.md` | `.opencode/skills/` |
+| Antigravity | `AGENTS.md` | `.antigravity/skills/` |
+| Universal | `AGENTS.md` | `.agent/skills/` |
+
+## Creating Skills
+
+A skill is a directory with a `SKILL.md` file:
+
+```
+my-skill/
+├── SKILL.md           # Required: Instructions for the AI
+├── references/        # Optional: Documentation
+├── scripts/           # Optional: Helper scripts
+└── assets/            # Optional: Templates, configs
+```
+
+### SKILL.md Format
+
+Follows the [Agent Skills specification](https://agentskills.io/specification):
+
+```markdown
+---
+name: my-skill
+description: What this skill does and when to use it. Include trigger keywords.
+license: MIT
+compatibility: Requires Node.js 18+
+metadata:
+  author: your-org
+  version: "1.0"
+---
+
+# My Skill
+
+Instructions for the AI agent on how to use this skill.
+
+## When to Use
+
+- Scenario 1
+- Scenario 2
+
+## Steps
+
+1. First step
+2. Second step
+```
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Lowercase alphanumeric with hyphens (max 64 chars) |
+| `description` | Yes | What it does and when to use it (max 1024 chars) |
+| `license` | No | License name or reference |
+| `compatibility` | No | Environment requirements |
+| `metadata` | No | Arbitrary key-value pairs |
+
+## CI/CD Usage
+
+```yaml
+# GitHub Actions example
+- name: Setup skills
+  run: |
+    npx skillkit install owner/skills --skills=lint,test,deploy --yes
+    npx skillkit sync --yes
+```
+
+## Programmatic API
+
+```typescript
+import {
+  findAllSkills,
+  discoverSkills,
+  detectAgent,
+  getAdapter,
+} from 'skillkit';
+
+// Find all installed skills
+const skills = findAllSkills(searchDirs);
+
+// Detect current agent
+const agent = await detectAgent();
+
+// Generate config
+const adapter = getAdapter(agent);
+const config = adapter.generateConfig(skills);
+```
+
+## Configuration
+
+Create `skillkit.yaml` in your project:
+
+```yaml
+version: 1
+agent: cursor           # Override auto-detection
+autoSync: true          # Auto-sync on changes
+enabledSkills:
+  - pdf
+  - xlsx
+disabledSkills:
+  - deprecated-skill
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions welcome! Please read our contributing guidelines.
+
+## Acknowledgments
+
+Implements the [Agent Skills](https://agentskills.io) open format, originally developed by Anthropic and adopted by leading AI development tools.

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node