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 v1.0+

Instalação

bun install

Uso

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:

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

Testes

# 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