ai-agent-config 2.0.5 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-agent-config",
-  "version": "2.0.5",
+  "version": "2.1.0",
   "description": "Universal Global Skills & Workflows for AI Coding Assistants (Claude Code, Antigravity, Cursor) - v2.0: User-configurable skill sources",
   "main": "index.js",
   "bin": {
@@ -42,7 +42,6 @@
     "bin/",
     "scripts/",
     "config/",
-    ".agent/",
     "index.js",
     "README.md"
   ]

package/.agent/skills/config-manager/SKILL.md

@@ -1,184 +0,0 @@
-# Config Manager Skill
-
-Manage ai-agent-config user configuration interactively.
-
-## When to Use This Skill
-
-Use this skill when the user needs to:
-- Add a new custom skill source from GitHub
-- Configure sync settings
-- Manage their skill sources (enable/disable/remove)
-- Export or import config files
-- Share config with team members
-- Understand how to configure ai-agent-config
-
-## Capabilities
-
-- **Source Management**: Add, remove, enable, disable custom skill sources
-- **Config Operations**: Get, set, validate, export, import config values
-- **Migration Support**: Help users migrate from v1 to v2
-- **Team Sharing**: Export configs for team collaboration
-
-## Command Reference
-
-### Source Management
-```bash
-# Add a custom source
-ai-agent source add <repo-url> --name <name> --branch <branch>
-
-# List all sources
-ai-agent source list
-
-# Enable/disable a source
-ai-agent source enable <name>
-ai-agent source disable <name>
-
-# Remove a custom source
-ai-agent source remove <name>
-
-# Get source info
-ai-agent source info <name>
-```
-
-### Config Management
-```bash
-# Get config value
-ai-agent config get <key>
-
-# Set config value
-ai-agent config set <key> <value>
-
-# Edit config in editor
-ai-agent config edit
-
-# Validate config
-ai-agent config validate
-
-# Export config
-ai-agent config export [output-file]
-
-# Import config
-ai-agent config import <file> [--merge]
-
-# Reset to defaults
-ai-agent config reset --yes
-```
-
-## Examples
-
-### Adding Company Skills
-
-**User**: "Add skills from my company's GitHub repo"
-
-**Assistant**: I'll help you add your company's skills repository. Use this command:
-
-```bash
-ai-agent source add https://github.com/yourcompany/ai-skills \
-  --name company-skills \
-  --branch main
-```
-
-After adding the source, you'll need to:
-1. Update skills: `ai-agent update --source company-skills`
-2. Edit config to specify which skills to use: `ai-agent config edit`
-3. Install to platforms: `ai-agent install`
-
-### Sharing Config with Team
-
-**User**: "How do I share my skill configuration with my team?"
-
-**Assistant**: You can export your config and share it with your team:
-
-```bash
-# Export your config
-ai-agent config export team-config.json
-
-# Team members can import it
-ai-agent config import team-config.json --merge
-```
-
-The `--merge` flag will combine your existing config with the imported one, keeping both official and custom sources.
-
-### Checking Current Config
-
-**User**: "What sources do I have configured?"
-
-**Assistant**: Run this command to see all your sources:
-
-```bash
-ai-agent source list
-```
-
-This will show both official sources (from the package) and your custom sources.
-
-## Config File Location
-
-- **User config**: `~/.ai-agent/config.json`
-- **Cache**: `~/.ai-agent-external-cache/`
-
-## Config Structure
-
-The v2.0 config file has this structure:
-
-```json
-{
-  "version": "2.0",
-  "sources": {
-    "official": [
-      {
-        "name": "vercel-labs",
-        "repo": "https://github.com/vercel-labs/agent-skills.git",
-        "branch": "main",
-        "enabled": true,
-        "skills": [...]
-      }
-    ],
-    "custom": [
-      {
-        "name": "my-skills",
-        "repo": "https://github.com/me/my-skills.git",
-        "branch": "main",
-        "enabled": true,
-        "skills": [...]
-      }
-    ]
-  },
-  "sync": {
-    "enabled": false,
-    "provider": null,
-    "config": {}
-  },
-  "preferences": {
-    "autoUpdate": true,
-    "updateInterval": "weekly"
-  }
-}
-```
-
-## Migration from v1.x
-
-If the user is on v1.x, help them migrate:
-
-```bash
-ai-agent init
-```
-
-This will automatically create the v2.0 config file with all official sources enabled.
-
-## Tips
-
-1. **Test before sharing**: Always validate your config before sharing: `ai-agent config validate`
-2. **Backup**: The config manager automatically creates backups when modifying config
-3. **Edit safely**: Use `ai-agent config edit` to open in your editor with syntax checking
-4. **Source names**: Use descriptive names for custom sources (e.g., "company-standards", "team-utils")
-
-## Troubleshooting
-
-**Problem**: "Source already exists" error
-**Solution**: Remove the old source first or use a different name
-
-**Problem**: Config validation errors
-**Solution**: Run `ai-agent config validate` to see specific errors, then fix manually or reset
-
-**Problem**: Can't find custom source
-**Solution**: Check the source is enabled: `ai-agent source info <name>`

package/.agent/skills/skill-updater/SKILL.md

@@ -1,167 +0,0 @@
-# Skill Updater
-
-Automatically update skills from all configured sources (official and custom).
-
-## When to Use This Skill
-
-Use this skill when the user wants to:
-- Update all skills from configured sources
-- Update a specific source
-- Update a specific skill
-- Sync latest changes from external repositories
-- Keep skills up to date with latest best practices
-
-## Capabilities
-
-- **Multi-Source Updates**: Updates from both official and custom sources
-- **Selective Updates**: Update specific source or skill
-- **Force Updates**: Overwrite local changes
-- **Progress Reporting**: Shows what was updated, copied, or skipped
-
-## Command Reference
-
-```bash
-# Update all skills from all sources
-ai-agent update
-
-# Update from specific source
-ai-agent update --source vercel-labs
-
-# Update specific skill
-ai-agent update --skill react-best-practices
-
-# Force overwrite existing skills
-ai-agent update --force
-
-# Combine options
-ai-agent update --source company-skills --force
-```
-
-## How It Works (v2.0)
-
-1. **Reads User Config**: Loads `~/.ai-agent/config.json`
-2. **Gets Enabled Sources**: Filters for enabled sources (official + custom)
-3. **Clones/Updates Repos**: For each source, clones to `~/.ai-agent-external-cache/`
-4. **Copies Skills**: Copies skills to `.agent/skills/` in the package directory
-5. **Reports Results**: Shows what was updated
-
-## Examples
-
-### Regular Update
-
-**User**: "Update my skills"
-
-**Assistant**: I'll update all your skills from configured sources:
-
-```bash
-ai-agent update
-```
-
-This will:
-- Pull latest from Vercel Labs, Everything Claude Code, etc.
-- Update your custom sources too
-- Copy new/updated skills to your system
-- Show what changed
-
-### Update After Adding Custom Source
-
-**User**: "I just added a custom source, how do I get the skills?"
-
-**Assistant**: After adding a source, update it:
-
-```bash
-# Update just your new source
-ai-agent update --source your-source-name
-
-# Then install to platforms
-ai-agent install
-```
-
-### Force Update
-
-**User**: "Some skills aren't updating"
-
-**Assistant**: Use `--force` to overwrite existing skills:
-
-```bash
-ai-agent update --force
-```
-
-⚠️ Warning: This will overwrite any local modifications you made to skills.
-
-## What's New in v2.0
-
-- ✅ **Custom Sources**: Updates from your custom sources, not just official ones
-- ✅ **User Config**: Reads from `~/.ai-agent/config.json` instead of hard-coded list
-- ✅ **Selective Sync**: Update specific sources or skills
-- ✅ **Better Reporting**: Shows which sources succeeded/failed
-
-## Update vs Install
-
-- **`ai-agent update`**: Downloads latest skills from sources to cache
-- **`ai-agent install`**: Installs cached skills to AI platforms (Claude, Antigravity, etc.)
-
-Typical workflow:
-```bash
-ai-agent update    # Get latest skills
-ai-agent install   # Install to platforms
-```
-
-## Configuration
-
-Skills are defined in your config file:
-
-```json
-{
-  "sources": {
-    "official": [
-      {
-        "name": "vercel-labs",
-        "enabled": true,
-        "skills": [
-          { "path": "skills/react-best-practices", "name": "react-best-practices" }
-        ]
-      }
-    ],
-    "custom": [
-      {
-        "name": "my-skills",
-        "enabled": true,
-        "skills": [
-          { "path": "skills/my-skill", "name": "my-skill" }
-        ]
-      }
-    ]
-  }
-}
-```
-
-## Backward Compatibility
-
-The old command still works:
-```bash
-ai-agent sync-external
-```
-
-This is now an alias for `ai-agent update`.
-
-## Tips
-
-1. **Regular Updates**: Run `ai-agent update` weekly to get latest skills
-2. **Check Before Install**: After update, review changes before installing
-3. **Test Custom Sources**: When adding custom sources, test with `--source` flag first
-4. **Use Version Control**: If modifying skills, use git to track changes
-
-## Troubleshooting
-
-**Problem**: "Failed to load user config"
-**Solution**: Run `ai-agent init` to create config file
-
-**Problem**: Update fails for a source
-**Solution**: Check repo URL is correct: `ai-agent source info <name>`
-
-**Problem**: Skills not appearing
-**Solution**: Make sure source is enabled: `ai-agent source list`
-
-**Problem**: Git errors
-**Solution**: Check internet connection and git is installed