---
slug: "parlamento-ai-skill"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/parlamento-ai/parlamento-ai-skill@main/README.md"
repo: "https://github.com/parlamento-ai/parlamento-ai-skill"
source_file: "README.md"
branch: "main"
---
# Parlamento AI Skills

Public skills from Parlamento AI for Claude Code and compatible AI agents.

**Current version: 2.1.4**

## Available Skills

| Skill | Description |
|-------|-------------|
| [research](https://github.com/parlamento-ai/parlamento-ai-skill/tree/HEAD/skills/research/) | Parliamentary transcripts analysis for Chile, Spain, Peru and EU. Generate PDF reports. |
| [mistral-ocr](https://github.com/parlamento-ai/parlamento-ai-skill/tree/HEAD/skills/mistral-ocr/) | Extract text from images and PDFs using Mistral OCR API. No external dependencies. |

---

## Installation

Each skill can be installed via **Claude Code Plugin** or **npx Skills (skills.sh)**.

### Claude Code Plugin

```bash
# 1. Add the marketplace
/plugin marketplace add Parlamento-ai/parlamento-ai

# 2. Install the skill you want
/plugin install parlamento-ai-research@parlamento-ai
/plugin install mistral-ocr@parlamento-ai
```

### npx Skills (universal - works with multiple AI agents)

```bash
# Install research skill
npx skills add https://github.com/Parlamento-ai/parlamento-ai --skill research

# Install mistral-ocr skill
npx skills add https://github.com/Parlamento-ai/parlamento-ai --skill mistral-ocr
```

---

## Research Skill

Analyze parliamentary sessions and generate professional PDF reports.

### Setup

1. Get your API key from [parlamento.ai](https://parlamento.ai)
2. Add to `~/.claude/settings.json`:

```json
{
  "env": {
    "PARLAMENTO_API_KEY": "pa_your_api_key"
  }
}
```

3. Restart Claude Code

### Usage

**Claude Code:**
```
/research [your request]
```

**Other agents (skills.sh):**
```
Analyze Chile's Health Committee sessions from this week
```

### Examples

```
/research analysis of Chile's Health Committee from the last week
/research compare Economy Committee sessions from Chile and Peru this month
/research what decrees about energy were published in Chile this week
/research EU Parliament plenary sessions summary for today
```

### Supported Countries

| Code | Country | Bodies | Official Journal |
|------|---------|--------|------------------|
| cl | Chile | Senate, Chamber of Deputies | Diario Oficial |
| es | Spain | Congress, Senate, Autonomous Communities | BOE |
| pe | Peru | Congress (unicameral) | - |
| eu | European Union | European Parliament | EUR-Lex |

---

## Mistral OCR Skill

Extract text from images and PDFs using Mistral's dedicated OCR API. **No external dependencies required** - PDFs are processed directly without needing pdftoppm, ImageMagick, or any other tools.

### Setup

1. Get your API key from [console.mistral.ai](https://console.mistral.ai/)
2. Add to `~/.claude/settings.json`:

```json
{
  "env": {
    "MISTRAL_API_KEY": "your-mistral-api-key"
  }
}
```

3. See [getting-started guide](https://github.com/parlamento-ai/parlamento-ai-skill/blob/HEAD/skills/mistral-ocr/reference/getting-started.md) for detailed instructions

### Features

- **PDF to Markdown** - Convert PDFs directly (no image conversion needed!)
- **Image to Text** - Extract text from PNG, JPG, WEBP, GIF
- **Structured Output** - Tables preserved with proper formatting
- **Multi-language** - Works with dozens of languages
- **No dependencies** - Works out of the box

### Usage

**Claude Code:**
```
Convert this PDF to markdown: document.pdf
Extract text from this image: screenshot.png
```

**Other agents (skills.sh):**
```
Extract text from this PDF and save as markdown
```

### Documentation

- [Getting Started](https://github.com/parlamento-ai/parlamento-ai-skill/blob/HEAD/skills/mistral-ocr/reference/getting-started.md) - API key setup
- [PDF to Markdown](https://github.com/parlamento-ai/parlamento-ai-skill/blob/HEAD/skills/mistral-ocr/reference/pdf-to-markdown.md) - PDF conversion
- [Output Formats](https://github.com/parlamento-ai/parlamento-ai-skill/blob/HEAD/skills/mistral-ocr/reference/formats.md) - JSON, Markdown, CSV
- [Step-by-Step Guide](https://github.com/parlamento-ai/parlamento-ai-skill/blob/HEAD/skills/mistral-ocr/reference/guide.md) - Complete tutorial

---

## Updating

### Claude Code Plugin

```
/plugin update parlamento-ai-research@parlamento-ai
/plugin update mistral-ocr@parlamento-ai
```

### npx Skills

```bash
npx skills update https://github.com/Parlamento-ai/parlamento-ai --skill research
npx skills update https://github.com/Parlamento-ai/parlamento-ai --skill mistral-ocr
```

### Enable Auto-Update (Claude Code)

1. Run `/plugin` to open plugin manager
2. Go to **Marketplaces** tab
3. Select `parlamento-ai`
4. Enable **Enable auto-update**

---

## Uninstalling

### Claude Code Plugin

```
/plugin
```
Go to **Installed** tab → select plugin → uninstall.

### npx Skills

```bash
npx skills remove research
npx skills remove mistral-ocr
```

### Clear Cache (if needed)

**Mac/Linux:**
```bash
rm -rf ~/.claude/plugins/cache/parlamento-ai
```

**Windows (PowerShell):**
```powershell
rm -r -fo ~/.claude/plugins/cache/parlamento-ai
```

---

## Links

- Website: [parlamento.ai](https://parlamento.ai)
- GitHub: [Parlamento-ai/parlamento-ai](https://github.com/Parlamento-ai/parlamento-ai)