# manageskill

Manage Claude Code skills - list, install, remove, and configure skills.

A TypeScript service with CLI, API client, and database integration.

## Features

- CLI tool for managing skills
- HTTP server with REST API
- PostgreSQL database with migrations
- Configuration management
- Installer for Claude/Codex tools

## Installation

```bash
# Install dependencies
bun install

# Copy environment file
cp .env.example .env

# Edit .env with your configuration
```

## Configuration

### Environment Variables

Edit `.env` file with your configuration:

```bash
# Database
DB_HOST=localhost
DB_PORT=5432
DB_NAME=manageskill_db
DB_USER=postgres
DB_PASSWORD=your-password-here

# Server
PORT=3000

# API
API_URL=https://api.example.com
API_KEY=your-api-key-here
```

### CLI Configuration

Configure the CLI tool:

```bash
# Set API URL
bun cli config --set-api-url https://api.example.com

# Set API key
bun cli config --set-api-key your-api-key-here

# Show current configuration
bun cli config --show
```

## Database Setup

```bash
# Run migrations
bun run db:migrate

# Seed database
bun run db:seed

# Reset database (migrate + seed)
bun run db:reset
```

## Development

```bash
# Start server with auto-reload
bun run dev

# Start server
bun run start
```

## CLI Usage

### Setup

```bash
# Interactive setup
bun run cli setup
```

### Managing Skills

```bash
# List all skills
bun run cli list

# List with options
bun run cli list --filter "category" --limit 20

# Get skill by ID
bun run cli get <skill-id>

# Search skills
bun run cli search "query" --limit 10

# Add skill
bun run cli add --name "Skill Name" --description "Description"

# Add skill with metadata
bun run cli add --name "Skill" --metadata '{"key": "value"}'
```

### Installation to Claude/Codex

```bash
# Install to both
bun run cli install <skill-id>

# Install to specific target
bun run cli install <skill-id> --target claude
bun run cli install <skill-id> --target codex

# Install multiple skills
bun run cli install <id1> <id2> <id3>

# Force overwrite
bun run cli install <skill-id> --force

# Clear installed skills
bun run cli install --clear

# List installed skills
bun run cli install --list
```

## API Endpoints

The server provides the following REST API endpoints:

### Health Check

```bash
GET /health
```

Returns server health status.

### Items

```bash
# List items
GET /api/items

# Create item
POST /api/items
Content-Type: application/json

{
  "name": "Skill name",
  "description": "Skill description",
  "metadata": {"key": "value"}
}
```

## Project Structure

```
.
├── bin/
│   └── cli.ts              # CLI entry point
├── src/
│   ├── lib/
│   │   ├── api-client.ts   # API client functions
│   │   ├── config.ts       # Configuration management
│   │   ├── installer.ts    # Claude/Codex installer
│   │   └── service-dir.ts  # Service directory management
│   ├── db/
│   │   └── index.ts        # Database connection
│   └── server/
│       └── index.ts        # HTTP server
├── scripts/
│   ├── migrate.ts          # Database migrations
│   └── seed.ts             # Database seeding
├── .env.example            # Environment template
├── package.json            # Package configuration
├── tsconfig.json           # TypeScript config
└── README.md               # Documentation
```

## Scripts

- `bun run dev` - Start server with auto-reload
- `bun run start` - Start server
- `bun run cli` - Run CLI tool
- `bun run db:migrate` - Run migrations
- `bun run db:seed` - Seed database
- `bun run db:reset` - Reset database (migrate + seed)

## License

Apache-2.0

## Author

Hasna