npm package: @ludandaye/ai-skill
Description: A CLI tool for managing and discovering AI skills
Author: ludandaye
Latest version: 1.0.0

# AI Skill Manager 🤖

A command-line tool for managing and discovering AI skills, inspired by `wget` and `brew`.

## Features

- 📋 **List & Search**: Browse and search AI skills from the command line
- ➕ **Add Skills**: Contribute new AI skills to the database
- 🔄 **GitHub Sync**: Sync skills from a centralized GitHub repository
- 📊 **Statistics**: View analytics about AI capabilities
- 🎨 **Beautiful CLI**: Colorful and intuitive terminal interface

## Installation

### Quick Install

```bash
curl -fsSL https://raw.githubusercontent.com/ludan-daye/ai-skill-manager/main/install.sh | bash
```

### Manual Install

```bash
git clone https://github.com/ludan-daye/ai-skill-manager.git
cd ai-skill-manager
npm install -g .
```

### From npm

```bash
npm install -g ai-skill
```

## Usage

### List all skills

```bash
ai-skill list
ai-skill ls                          # Short alias

# Filter by category
ai-skill list --category NLP

# Filter by proficiency
ai-skill list --proficiency Advanced
```

### Search for skills

```bash
ai-skill search "language"
ai-skill search vision
```

### Show skill details

```bash
ai-skill show nlp001
```

### Download a skill from remote repository

```bash
ai-skill download nlp001
ai-skill install vision001           # Alias
```

### Add a new skill

```bash
ai-skill add
```

Follow the interactive prompts to add:
- Skill name
- Category (NLP, Vision, Reasoning, Audio, Multimodal, Robotics, Other)
- Description
- Proficiency level (Beginner, Intermediate, Advanced, Expert)
- Tags

### Remove a skill

```bash
ai-skill remove nlp001
ai-skill rm nlp001                   # Short alias
```

### Download a specific skill from GitHub

```bash
ai-skill download nlp001
ai-skill install vision001           # Alias
```

Download a single skill from the remote repository and add it to your local collection. If the skill already exists locally, you'll be prompted to overwrite it.

### Export a skill for sharing

```bash
ai-skill export nlp001
ai-skill publish vision001           # Alias
```

Export a skill to a JSON file in your Downloads folder. This allows you to:
- Share the skill with others
- Submit it as a Pull Request to the GitHub repository
- Backup individual skills

### Sync from GitHub

```bash
ai-skill sync
```

This fetches all skills from the GitHub repository and intelligently merges them with your local collection. New skills are added, updated skills are synchronized, and your local-only skills are preserved.

### View statistics

```bash
ai-skill stats
```

Shows:
- Total number of skills
- Distribution by category
- Distribution by proficiency level

## GitHub Integration

The tool stores skills locally in `~/.ai-skill/skills.json` and can sync with a GitHub repository.

### Setting up your GitHub repository

1. Create a new GitHub repository (e.g., `ai-skills-database`)
2. Add a `skills.json` file with your skills data
3. Set the repository URL:

```bash
export AI_SKILL_REPO="username/ai-skills-database"
```

Add this to your `.bashrc` or `.zshrc` to make it permanent.

### Repository structure

```
your-repo/
├── skills.json          # Main skills database
└── README.md           # Repository documentation
```

### Skills JSON format

```json
[
  {
    "id": "unique-id",
    "name": "Skill Name",
    "category": "Category",
    "description": "Detailed description",
    "proficiency": "Advanced",
    "tags": ["tag1", "tag2"],
    "createdAt": "2026-01-22T13:55:00.000Z"
  }
]
```

## Data Storage

- Local storage: `~/.ai-skill/skills.json`
- First run: Creates default skills automatically
- Sync: Overwrites local data with GitHub repository data

## Contributing

Contributions are welcome! You can:

1. Add skills via the CLI: `ai-skill add`
2. Fork the GitHub repository and submit PRs
3. Report issues or suggest features

## Categories

- **NLP**: Natural Language Processing
- **Vision**: Computer Vision
- **Reasoning**: Logic and Problem Solving
- **Audio**: Speech and Audio Processing
- **Multimodal**: Cross-modal Understanding
- **Robotics**: Physical World Interaction
- **Other**: Miscellaneous Skills

## Proficiency Levels

- **Beginner**: Basic understanding
- **Intermediate**: Practical application
- **Advanced**: Deep expertise
- **Expert**: State-of-the-art

## Examples

```bash
# Discover NLP skills
ai-skill list --category NLP

# Find all vision-related skills
ai-skill search vision

# Get details about a specific skill
ai-skill show vision001

# Download a specific skill from remote
ai-skill download nlp001

# Add your expertise
ai-skill add

# Export a skill to share with others
ai-skill export nlp001

# Check what's in the database
ai-skill stats

# Sync with latest community skills
ai-skill sync
```

## Requirements

- Node.js >= 14.0.0
- npm >= 6.0.0

## License

MIT

## Support

- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: ludandaye@gmail.com

---

Made with ❤️ for the AI community