# Import Skills Power

MCP Server para importar, gerenciar e utilizar skills (arquivos Markdown) de repositórios GitHub remotos. Integra-se ao Kiro como um Power, expondo 5 ferramentas via protocolo MCP sobre transporte stdio.

## Tools

| Tool | Descrição | Parâmetros |
|------|-----------|------------|
| `list_remote_skills` | Lista skills disponíveis em um repositório GitHub | `repoUrl`, `token?` |
| `install_skill` | Instala skill(s) de um repositório para armazenamento local | `repoUrl`, `skillPath?`, `token?` |
| `list_installed_skills` | Lista todas as skills instaladas localmente | — |
| `get_skill_content` | Retorna o conteúdo completo de uma skill instalada | `skillName` |
| `remove_skill` | Remove uma skill instalada | `skillName` |

## Requisitos

- [Bun](https://bun.sh) v1.0+

## Instalação

```bash
bun install
```

## Uso

```bash
bun run start
```

O servidor inicia via stdio e aguarda chamadas MCP. As skills instaladas são persistidas em `~/.kiro/skills/`.

## Configuração no Kiro

Adicione ao seu `mcp.json`:

```json
{
  "mcpServers": {
    "import-skills": {
      "command": "bun",
      "args": ["run", "start"],
      "cwd": "/caminho/para/import-skills"
    }
  }
}
```

## Testes

```bash
# Todos os testes (property-based, unit, integração)
bun test

# Apenas property tests
bun test tests/properties/

# Apenas unit tests
bun test tests/unit/

# Apenas integração
bun test tests/integration/
```

## Estrutura do Projeto

```
src/
├── index.ts              # Entry point - MCP Server setup
├── tools/
│   ├── list-remote.ts    # list_remote_skills
│   ├── install.ts        # install_skill
│   ├── list-installed.ts # list_installed_skills
│   ├── get-content.ts    # get_skill_content
│   └── remove.ts         # remove_skill
├── services/
│   ├── github.ts         # GitHub API (Trees + Contents)
│   ├── storage.ts        # Filesystem local
│   └── registry.ts       # Registry JSON de metadados
├── utils/
│   └── url-parser.ts     # Parser de URLs GitHub
│   └── name-extractor.ts # Extração de nome de skill
└── types/
    └── index.ts          # Tipos compartilhados
```

## Armazenamento Local

```
~/.kiro/skills/
├── registry.json          # Metadados das skills instaladas
└── owner-repo/            # Namespace por repositório
    └── skill.md
```

## Stack

- **Runtime**: Bun
- **Linguagem**: TypeScript (ESNext modules)
- **MCP SDK**: @modelcontextprotocol/sdk
- **Validação**: Zod
- **Testes PBT**: fast-check