Agent skill

Parliament CLI

Explore UK bills, MPs, votes, and written questions using official Parliament data.

Use this skill

Install it into a project with the Skills CLI, or read the files below and adapt them to your own agent.

npx skills add shan8851/agent-skills --skill parliament-cli

SKILL.md

---
name: parliament-cli
description: UK Parliament CLI — search bills, divisions, members, and written questions from official UK Parliament APIs, with stable JSON envelopes for agents. Use when looking up UK Parliament bills, members, votes/divisions, written questions, or when an agent needs structured Parliament API results.
clawhubUrl: https://clawhub.ai/shan8851/parliament-cli
---

# parliament-cli

Use `parliament` for UK Parliament data: bills, members, divisions/votes, and written questions.

Setup

- `npm install -g @shan8851/parliament-cli`
- No API key or auth required

Bills

- By id: `parliament bill 3973`
- By title: `parliament bill "renters rights"`
- Search: `parliament search bills "energy"`

Divisions and Votes

- Search divisions: `parliament divisions "budget"`
- Lookup by id: `parliament divisions 2211`
- Alias: `parliament votes 2211`

Members

- By name: `parliament member "Keir Starmer"`
- By id: `parliament member 4514`

Written Questions

- Search: `parliament questions "transport"`
- Lookup by id or UIN query: `parliament questions 902178`

Output

- Defaults to text in a TTY and JSON when piped
- Force JSON: `parliament bill 3973 --json`
- Success envelope: `{ ok, schemaVersion, command, requestedAt, data }`
- Error envelope: `{ ok, schemaVersion, command, requestedAt, error }`

Agent Notes

- Ambiguous text queries return `AMBIGUOUS_QUERY` with candidate hints in `error.details`
- No auth setup needed, so agents can use it immediately
- Exit codes are explicit and errors stay structured in JSON mode

Notes

- Official sources include the Bills, Members, Written Questions, and Commons Votes APIs
- `votes` is an alias of `divisions`