antikit 1.9.0 → 1.9.1

package/README.md

@@ -8,25 +8,54 @@ CLI tool to manage AI agent skills from multiple repositories. Easily discover,
 npm install -g antikit
 ```
 
+## Features
+
+- **Multi-source Support**: Fetch skills from any GitHub repository.
+- **Sub-directory Support**: Skills can reside in sub-folders (e.g. `.claude/skills`).
+- **Interactive UI**: Browse, select, and update skills with a rich terminal UI.
+- **Dependency Management**: Automatically resolves and installs skill dependencies defined in `SKILL.md`.
+- **Smart Upgrades**: Detects version changes and allows easy upgrades.
+- **Autocomplete**: Full Zsh/Bash comparison support.
+
 ## Usage
 
-### 📦 Manage Skills
+### � Quick Start
 
-#### List available skills
+**1. Setup Autocomplete (Recommended)**
+
+```bash
+antikit completion
+# Follow instructions to add to ~/.zshrc or ~/.bashrc
+```
+
+**2. Browse & Install Skills**
 
 ```bash
 antikit list
-# or
+# or simply
+antikit ls
+```
+
+_Shows an interactive menu to search, select, and install/update skills._
+
+---
+
+### �📦 Manage Skills
+
+#### List available skills
+
+```bash
+# Interactive mode (Default) - Browse, Multi-select, Update
 antikit ls
 
 # Search skills by name
-antikit list -s <query>
+antikit ls -s <query>
 
-# Interactive mode (select and install)
-antikit list -i
+# Text mode (Non-interactive list)
+antikit ls --text
 
 # Filter by source
-antikit list --source official
+antikit ls --source official
 ```
 
 #### Install a skill
@@ -49,6 +78,8 @@ Update your local skills to the latest version from their sources.
 ```bash
 # Upgrade all installed skills
 antikit upgrade
+# or
+antikit ug
 
 # Upgrade a specific skill
 antikit upgrade <skill-name>
@@ -77,14 +108,17 @@ antikit rm <skill-name>
 
 ### 📡 Manage Sources
 
-You can fetch skills from multiple GitHub repositories.
+You can fetch skills from multiple GitHub repositories, even from sub-directories.
 
 ```bash
 # List configured sources
 antikit source list
 
-# Add a new source (GitHub owner/repo)
-antikit source add vunamhung/another-repo
+# Add a standard Repo source (GitHub owner/repo)
+antikit source add vunamhung/antiskills
+
+# Add a source from a SUB-DIRECTORY (e.g. monorepo)
+antikit source add mrgoonie/claudekit-skills --path .claude/skills --name claudekit
 
 # Add with a custom name
 antikit source add vunamhung/private-skills --name private
@@ -116,14 +150,15 @@ _Note: You will also be notified automatically if a new version is available whe
 
 A skill is a directory containing a `SKILL.md` file.
 
-### Defining Dependencies
+### Defining Version & Dependencies
 
-You can specify dependencies in the `SKILL.md` frontmatter. `antikit` will automatically install them.
+You can specify version and dependencies in the `SKILL.md` frontmatter.
 
 ```yaml
 ---
 name: my-skill
 description: A powerful skill that needs helpers
+version: 1.0.1
 dependencies:
   - sql-helper
   - python-runner
@@ -136,7 +171,6 @@ dependencies:
 
 - Node.js >= 18.0.0
 - Git (for cloning skills)
-- A project with `.agent/skills` directory (created automatically)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antikit",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "CLI tool to manage AI agent skills from Anti Gravity skills repository",
   "type": "module",
   "main": "src/index.js",

package/src/utils/configManager.js

@@ -13,6 +13,20 @@ const DEFAULT_CONFIG = {
       repo: 'antiskills',
       branch: 'main',
       default: true
+    },
+    {
+      name: 'claudekit',
+      owner: 'mrgoonie',
+      repo: 'claudekit-skills',
+      branch: 'main',
+      path: '.claude/skills'
+    },
+    {
+      name: 'ui-ux-pro',
+      owner: 'nextlevelbuilder',
+      repo: 'ui-ux-pro-max-skill',
+      branch: 'main',
+      path: '.claude/skills'
     }
   ]
 };
@@ -58,7 +72,14 @@ export function saveConfig(config) {
  */
 export function getSources() {
   const config = loadConfig();
-  return config.sources || [];
+  const sources = config.sources || [];
+
+  // Enforce 'official' source always at the top
+  return sources.sort((a, b) => {
+    if (a.name === 'official') return -1;
+    if (b.name === 'official') return 1;
+    return 0;
+  });
 }
 
 /**

package/src/utils/github.js

@@ -2,6 +2,18 @@ import { getSources } from './configManager.js';
 
 const GITHUB_API = 'https://api.github.com';
 
+function getHeaders() {
+  const headers = {
+    Accept: 'application/vnd.github.v3+json',
+    'User-Agent': 'antikit-cli'
+  };
+  const token = process.env.ANTIKIT_GITHUB_TOKEN || process.env.GITHUB_TOKEN;
+  if (token) {
+    headers.Authorization = `token ${token}`;
+  }
+  return headers;
+}
+
 /**
  * Fetch list of skills from a specific source
  */
@@ -12,14 +24,19 @@ async function fetchSkillsFromSource(source) {
   }
 
   const response = await fetch(url, {
-    headers: {
-      Accept: 'application/vnd.github.v3+json',
-      'User-Agent': 'antikit-cli'
-    }
+    headers: getHeaders()
   });
 
   if (!response.ok) {
     const data = await response.json().catch(() => ({}));
+
+    // Check for rate limit
+    if (response.status === 403 && data.message.includes('rate limit')) {
+      console.error('\n⚠️  GitHub API rate limit exceeded.');
+      console.error(
+        'Please set GITHUB_TOKEN or ANTIKIT_GITHUB_TOKEN environment variable to increase limit.\n'
+      );
+    }
     // Handle empty repository
     if (data.message === 'This repository is empty.') {
       return [];
@@ -91,10 +108,7 @@ export async function fetchSkillInfo(skillName, owner, repo, path = null) {
   url += `/${skillName}/SKILL.md`;
 
   const response = await fetch(url, {
-    headers: {
-      Accept: 'application/vnd.github.v3+json',
-      'User-Agent': 'antikit-cli'
-    }
+    headers: getHeaders()
   });
 
   if (!response.ok) {