skillkit 1.2.0 → 1.3.1

package/LICENSE

@@ -1,21 +1,190 @@
-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.
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Rohit Ghumare
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,407 +1,41 @@
 # SkillKit
 
-[![npm version](https://img.shields.io/npm/v/skillkit.svg)](https://www.npmjs.com/package/skillkit)
-[![npm downloads](https://img.shields.io/npm/dm/skillkit.svg)](https://www.npmjs.com/package/skillkit)
-[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-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.
-
-![SkillKit Demo](https://raw.githubusercontent.com/rohitg00/skillkit/main/skillkit.gif)
-
-## Interactive TUI
-
-Manage all your skills with a beautiful terminal interface:
-
-```bash
-skillkit ui
-# or simply
-skillkit
-```
-
-![SkillKit TUI](docs/img/skillkit-ui.png)
-
-**Features:**
-- Browse 33+ skill repositories
-- Install skills with one keystroke
-- Multi-agent installation support
-- View installed skills
-- Sync across agents
-- Responsive design for all terminal sizes
-
-**Navigation:**
-- `h` Home | `b` Browse | `l` List | `s` Sync | `,` Config
-- `↑↓` Navigate | `Enter` Select | `Esc` Back | `q` Quit
-- `m` Multi-agent selection | `r` Refresh/Back
-
-### Compatible With
-
-| Agent | Status |
-|-------|--------|
-| Claude Code | ✅ Native |
-| OpenAI Codex | ✅ Native |
-| Cursor | ✅ Native |
-| Gemini CLI | ✅ Native |
-| OpenCode | ✅ Native |
-| Antigravity | ✅ Native |
-| Amp | ✅ Native |
-| Clawdbot | ✅ Native |
-| Droid (Factory) | ✅ Native |
-| GitHub Copilot | ✅ Native |
-| Goose | ✅ Native |
-| Kilo Code | ✅ Native |
-| Kiro CLI | ✅ Native |
-| Roo Code | ✅ Native |
-| Trae | ✅ Native |
-| Windsurf | ✅ Native |
-| *Any markdown-config agent* | ✅ Universal |
-
-## Features
-
-- **Interactive TUI**: Beautiful terminal interface for managing skills
-- **Multi-Agent Support**: Works with 17+ 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
+Universal skills manager for AI coding agents. Install, manage, and sync skills across 17+ AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
 
 ## Installation
 
 ```bash
 npm install -g skillkit
-# or
-npx skillkit <command>
 ```
 
 ## Quick Start
 
 ```bash
-# Launch interactive TUI
-skillkit ui
-
-# Initialize in your project (auto-detects agent)
+# Initialize skillkit in your project
 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
-
-# Create a new skill
-skillkit create my-skill
-
-# 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 |
+# Install a skill
+skillkit install github.com/anthropics/courses:prompt-eng/interactive-tutorial
 
-
-## Commands
-
-### `skillkit ui` / `skillkit`
-
-Launch the interactive Terminal User Interface (TUI) for managing skills.
-
-```bash
-skillkit ui          # Explicit TUI launch
-skillkit             # Launch TUI if no arguments provided
-```
-
-**TUI Features:**
-- **Browse**: Discover skills from 33+ repositories
-- **List**: View all installed skills
-- **Sync**: Sync skills across multiple agents
-- **Settings**: Configure SkillKit preferences
-
-**Keyboard Shortcuts:**
-- `h` - Home screen
-- `b` - Browse skills marketplace
-- `l` - List installed skills
-- `s` - Sync skills across agents
-- `,` - Settings
-- `↑↓` - Navigate lists
-- `Enter` - Select / Install
-- `m` - Multi-agent selection (when viewing skills)
-- `r` - Refresh / Go back
-- `Esc` - Return to home
-- `q` - Quit
-
-### `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
---list               # List available skills without installing
---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
---agent=cursor       # Install to specific agent (can specify multiple)
-```
-
-### `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
+# List installed skills
 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
-```
-
-### `skillkit create <skill-name>`
-
-Create a new skill with proper structure and template.
-
-```bash
-skillkit create my-skill                    # Basic skill
-skillkit create my-skill --full             # Include all directories (references, scripts, assets)
-skillkit create my-skill --scripts          # Include scripts directory
-skillkit create my-skill --references       # Include references directory
-skillkit create my-skill --assets           # Include assets directory
-skillkit create my-skill --dir ./skills     # Create in specific directory
-```
-
-## Supported Agents
 
-| Agent | Config File | Project Path | Global Path |
-|-------|-------------|--------------|-------------|
-| Claude Code | `AGENTS.md` | `.claude/skills/` | `~/.claude/skills/` |
-| Cursor | `.cursorrules` | `.cursor/skills/` | `~/.cursor/skills/` |
-| Codex | `AGENTS.md` | `.codex/skills/` | `~/.codex/skills/` |
-| Gemini CLI | `GEMINI.md` | `.gemini/skills/` | `~/.gemini/skills/` |
-| OpenCode | `AGENTS.md` | `.opencode/skills/` | `~/.config/opencode/skills/` |
-| Antigravity | `AGENTS.md` | `.antigravity/skills/` | `~/.gemini/antigravity/skills/` |
-| Amp | `AGENTS.md` | `.agents/skills/` | `~/.config/agents/skills/` |
-| Clawdbot | `AGENTS.md` | `skills/` | `~/.clawdbot/skills/` |
-| Droid (Factory) | `AGENTS.md` | `.factory/skills/` | `~/.factory/skills/` |
-| GitHub Copilot | `AGENTS.md` | `.github/skills/` | `~/.copilot/skills/` |
-| Goose | `AGENTS.md` | `.goose/skills/` | `~/.config/goose/skills/` |
-| Kilo Code | `AGENTS.md` | `.kilocode/skills/` | `~/.kilocode/skills/` |
-| Kiro CLI | `AGENTS.md` | `.kiro/skills/` | `~/.kiro/skills/` |
-| Roo Code | `AGENTS.md` | `.roo/skills/` | `~/.roo/skills/` |
-| Trae | `AGENTS.md` | `.trae/skills/` | `~/.trae/skills/` |
-| Windsurf | `AGENTS.md` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
-| Universal | `AGENTS.md` | `.agent/skills/` | `~/.agent/skills/` |
-
-## Creating Skills
-
-Use `skillkit create <name>` to scaffold a new skill, or create manually:
-
-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
+# Launch interactive TUI
+skillkit ui
 ```
 
-## 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);
-```
+## Features
 
-## Configuration
+- **17+ Agent Support**: Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, and more
+- **Universal Skill Translation**: Convert skills between different agent formats
+- **Smart Recommendations**: Get skill suggestions based on your project stack
+- **Project Context Sync**: One config, all agents
+- **Interactive TUI**: Browse, install, and manage skills visually
 
-Create `skillkit.yaml` in your project:
+## Documentation
 
-```yaml
-version: 1
-agent: cursor           # Override auto-detection
-autoSync: true          # Auto-sync on changes
-enabledSkills:
-  - pdf
-  - xlsx
-disabledSkills:
-  - deprecated-skill
-```
+Full documentation: https://github.com/rohitg00/skillkit
 
 ## 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.
+Apache-2.0

package/dist/cli.d.ts

@@ -1 +1,4 @@
 #!/usr/bin/env node
+import '@skillkit/core';
+import '@skillkit/agents';
+import '@skillkit/tui';