How do I install the Plonkboard skill?

Run npx skillmds@latest add clayton/plonkboard in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Plonkboard safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Plonkboard?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Plonkboard free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Plonkboard?

clayton (@clayton) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Plonkboard by clayton — Agent Skill

Name: Plonkboard
Author: clayton

Plonkboard

Manage Kanban boards, cards, columns, tags, subtasks, priorities, assignees, and archives through the Plonkboard REST API. Use when the user mentions Plonkboard, plonkboard.com, an agent-driven Kanban board, or asks an agent to create, read, update, move, tag, archive, or delete Plonkboard work.

clayton cbd2e25 2 files · 4.6 KB Updated Sep 17, 2026

File contents

Plonkboard

Use Plonkboard as the user's Kanban system. The web UI is read-only. Make changes through the REST API.

Set up

Read https://plonkboard.com/llms.txt before using the API. It is the canonical, current reference.
Read PLONKBOARD_API_KEY from the environment or the agent's secret store. Never print or commit it.
If the user gives you a one-time boot_... token, exchange it once:

curl -fsS https://plonkboard.com/api/v1/bootstrap/exchange \
  -H 'Content-Type: application/json' \
  -d "{\"token\":\"$PLONKBOARD_BOOTSTRAP_TOKEN\"}"

Store the returned token as PLONKBOARD_API_KEY, then remove the bootstrap token. Do not echo either token.

If no credential exists, ask the user to open https://plonkboard.com/settings/api_keys and click "copy setup prompt for my agent".

Call the API

Send these headers on protected requests:

Authorization: Bearer <PLONKBOARD_API_KEY>
Accept: text/markdown

Prefer text/markdown for compact reads. Use JSON for writes:

Content-Type: application/json

Start each task by listing boards unless the user already supplied a board ID. Resolve names to IDs. Plonkboard IDs use prefixes such as brd_, col_, crd_, and tag_.

Work safely

Confirm the target board and card before a destructive action.
Do not create, move, archive, or delete work unless the user asked.
Preserve the user's wording in titles and descriptions unless asked to edit it.
Honor column WIP limits. Moving a card into an over-limit column can archive older cards.
Use tag_names on card writes when the user names tags. Plonkboard finds or creates them.
Use only these priorities: low, medium, high, critical.

Common endpoints

GET    /api/v1/boards
POST   /api/v1/boards
GET    /api/v1/boards/:board_id
PATCH  /api/v1/boards/:board_id
DELETE /api/v1/boards/:board_id

POST   /api/v1/boards/:board_id/columns
PATCH  /api/v1/boards/:board_id/columns/:id
DELETE /api/v1/boards/:board_id/columns/:id

GET    /api/v1/boards/:board_id/cards
POST   /api/v1/boards/:board_id/cards
GET    /api/v1/boards/:board_id/cards/:id
PATCH  /api/v1/boards/:board_id/cards/:id
DELETE /api/v1/boards/:board_id/cards/:id
PATCH  /api/v1/boards/:board_id/cards/:id/move

GET    /api/v1/boards/:board_id/tags
POST   /api/v1/boards/:board_id/tags
PATCH  /api/v1/boards/:board_id/tags/:id
DELETE /api/v1/boards/:board_id/tags/:id

GET    /api/v1/boards/:board_id/cards/:card_id/subtasks
POST   /api/v1/boards/:board_id/cards/:card_id/subtasks
PATCH  /api/v1/boards/:board_id/cards/:card_id/subtasks/:id
DELETE /api/v1/boards/:board_id/cards/:card_id/subtasks/:id

GET    /api/v1/boards/:board_id/archive
GET    /api/v1/boards/:board_id/archive/:id

Read references/examples.md for concise request examples. Re-read https://plonkboard.com/llms.txt if an endpoint or field is unclear.

---name: plonkboarddescription: Manage Kanban boards, cards, columns, tags, subtasks, priorities, assignees, and archives through the Plonkboard REST API. Use when the user mentions Plonkboard, plonkboard.com, an agent-driven Kanban board, or asks an agent to create, read, update, move, tag, archive, or delete Plonkboard work.license: MIT---# PlonkboardUse Plonkboard as the user's Kanban system. The web UI is read-only. Make changes through the REST API.## Set up1. Read `https://plonkboard.com/llms.txt` before using the API. It is the canonical, current reference.2. Read `PLONKBOARD_API_KEY` from the environment or the agent's secret store. Never print or commit it.3. If the user gives you a one-time `boot_...` token, exchange it once:```shcurl -fsS https://plonkboard.com/api/v1/bootstrap/exchange \ -H 'Content-Type: application/json' \ -d "{\"token\":\"$PLONKBOARD_BOOTSTRAP_TOKEN\"}"```Store the returned `token` as `PLONKBOARD_API_KEY`, then remove the bootstrap token. Do not echo either token.If no credential exists, ask the user to open `https://plonkboard.com/settings/api_keys` and click "copy setup prompt for my agent".## Call the APISend these headers on protected requests:```textAuthorization: Bearer <PLONKBOARD_API_KEY>Accept: text/markdown```Prefer `text/markdown` for compact reads. Use JSON for writes:```textContent-Type: application/json```Start each task by listing boards unless the user already supplied a board ID. Resolve names to IDs. Plonkboard IDs use prefixes such as `brd_`, `col_`, `crd_`, and `tag_`.## Work safely- Confirm the target board and card before a destructive action.- Do not create, move, archive, or delete work unless the user asked.- Preserve the user's wording in titles and descriptions unless asked to edit it.- Honor column WIP limits. Moving a card into an over-limit column can archive older cards.- Use `tag_names` on card writes when the user names tags. Plonkboard finds or creates them.- Use only these priorities: `low`, `medium`, `high`, `critical`.## Common endpoints```textGET /api/v1/boardsPOST /api/v1/boardsGET /api/v1/boards/:board_idPATCH /api/v1/boards/:board_idDELETE /api/v1/boards/:board_idPOST /api/v1/boards/:board_id/columnsPATCH /api/v1/boards/:board_id/columns/:idDELETE /api/v1/boards/:board_id/columns/:idGET /api/v1/boards/:board_id/cardsPOST /api/v1/boards/:board_id/cardsGET /api/v1/boards/:board_id/cards/:idPATCH /api/v1/boards/:board_id/cards/:idDELETE /api/v1/boards/:board_id/cards/:idPATCH /api/v1/boards/:board_id/cards/:id/moveGET /api/v1/boards/:board_id/tagsPOST /api/v1/boards/:board_id/tagsPATCH /api/v1/boards/:board_id/tags/:idDELETE /api/v1/boards/:board_id/tags/:idGET /api/v1/boards/:board_id/cards/:card_id/subtasksPOST /api/v1/boards/:board_id/cards/:card_id/subtasksPATCH /api/v1/boards/:board_id/cards/:card_id/subtasks/:idDELETE /api/v1/boards/:board_id/cards/:card_id/subtasks/:idGET /api/v1/boards/:board_id/archiveGET /api/v1/boards/:board_id/archive/:id```Read [references/examples.md](references/examples.md) for concise request examples. Re-read `https://plonkboard.com/llms.txt` if an endpoint or field is unclear.

Frequently asked questions

Plonkboard

File contents

Plonkboard

Set up

Call the API

Work safely

Common endpoints

Related skills

Frequently asked questions

How do I install the Plonkboard skill?

What does the Plonkboard skill do?

Is Plonkboard safe to use?

Which AI agents work with Plonkboard?

Is Plonkboard free to use?

Who published Plonkboard?