Metadata-Version: 2.4
Name: agentskill-cli
Version: 1.0.0
Summary: Universal AI Skill Manager for GitHub Copilot, Claude, Cursor
Author: Parth
License: MIT
Keywords: ai,copilot,claude,cursor,skills,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0

# AgentSkill 🛠️

**Universal AI Skill Manager** — Manage skills for GitHub Copilot, Claude Code, Cursor, and more.

## Features

- ✅ **Zero Config**: No setup needed, just install and use
- ✅ **Multi-AI Support**: GitHub Copilot, Claude Code, Cursor
- ✅ **Any Language**: Python, JavaScript, Go, Rust, Dart, etc.
- ✅ **Framework Templates**: React, Django, FastAPI, Flutter, Gin, etc.
- ✅ **One Command Install**: Auto-detects AI tools in project
- ✅ **Sync Updates**: Update skill → all projects sync automatically

## Installation (One Time)

```bash
cd /path/to/Agent_Skill
pip install -e .
```

That's it! Now `agentskill` command works globally.

## Quick Start

```bash
# Create a skill (auto-stored in ~/.agentskill/skills/)
agentskill create react-rules -l javascript -f react

# Go to any project and install
cd /your/react-project
agentskill install react-rules

# Done! AI will follow your rules
```

## Commands

| Command | Description |
|---------|-------------|
| `create <name>` | Create new skill |
| `install <name>` | Install in current project |
| `list` | Show all skills |
| `show <name>` | View skill details |
| `edit <name>` | Open in editor |
| `update <name>` | Sync to all projects |
| `delete <name>` | Remove skill |
| `export <name>` | Export as zip |
| `import <zip>` | Import from zip |
| `init` | Create AI folders |
| `where` | Show storage location |

**Shortcut**: Use `ask` instead of `agentskill`

## Creating Skills

### Basic

```bash
agentskill create my-rules
```

### With Language & Framework

```bash
# React skill
agentskill create react-component -l javascript -f react

# Django skill
agentskill create django-api -l python -f django

# Flutter skill
agentskill create flutter-widget -l dart -f flutter

# Go API skill
agentskill create go-api -l go -f gin
```

### Supported Templates

| Language | Frameworks |
|----------|------------|
| Python | django, fastapi, flask |
| JavaScript | react, nextjs, node |
| Dart | flutter |
| Go | gin, fiber |
| Rust | actix, axum |

## Installing Skills

### Auto-detect (recommended)

```bash
cd /path/to/project
agentskill install my-skill
```

Auto-detects `.github/`, `.claude/`, `.cursor/` folders.

### Specific Tool

```bash
# GitHub Copilot only
agentskill install my-skill -t copilot

# Claude only
agentskill install my-skill -t claude

# All tools
agentskill install my-skill -t all
```

## Skill Structure

```
my-skill/
├── SKILL.md          # Main instructions (Copilot format)
├── skill.yaml        # SkillForge metadata
├── instructions.md   # Legacy format
├── scripts/          # Helper scripts
├── references/       # Additional docs
└── assets/           # Templates, boilerplate
```

## Editing Skills

```bash
# Open in editor (VS Code, Cursor, etc.)
agentskill edit my-skill

# Or show details first
agentskill show my-skill
```

After editing, update all projects:
```bash
agentskill update my-skill
```

## Sharing Skills

```bash
# Export
agentskill export my-skill

# Import
agentskill import my-skill.skill.zip
```

## How It Works

1. **Skills are stored** in `~/.agentskill/skills/` (automatic)
2. **Install copies** skill to your project's AI folder
3. **AI reads** the SKILL.md when you code

```
~/.agentskill/skills/          Your Projects
┌────────────────────┐         ┌─────────────────┐
│ react-rules/       │         │ my-react-app/   │
│   └── SKILL.md     │──copy──▶│   └── .github/  │
│ django-api/        │         │       └── skills│
│   └── SKILL.md     │         │           └── react-rules/
└────────────────────┘         └─────────────────┘
```

## Tips

- Keep SKILL.md under 500 lines
- Use `references/` for detailed docs
- Add code examples in `references/examples.md`
- Use specific trigger words in descriptions

## License

MIT
