Skip to content

Doc type

Everything else

Status pages and reports, with the number up top.

Any page that isn’t a system doc, a plan, a review or a design: a status page, an incident report, an inventory. It opens with a TL;DR and one stat that sums it up; ticks, picks and comments work as on every type.

InstallView on GitHub
"type": "other"

Read a weekly status page. The TL;DR states the answer, then one section per question the reader brings: the numbers, the incident, next week’s tasks.

What it’s for

One free layout, with its own label.

The agent names the kind of page; the label shows above the title and on the home card.

  • Status

    The week’s numbers, what broke and what is next.

  • Incident report

    What happened, when, the cause and the fix.

  • Inventory

    Everything of one kind, one row each, with what to do about it.

  • Meeting notes

    Decisions taken, open questions and the tasks that came out.

  • Comparison

    Options side by side as cards, with a pick to make.

Features

What you can do on the page.

Spot the hero stat on the home card

One number sums the page up, with an icon and a label. The home page shows it on the doc’s card.

See what changed since last week

Next week’s update is a new revision of the same page. Compare the two and the title, the TL;DR and the table cells that moved are marked word by word.

Works on every doc

Comments, revisions and approval, the same on every type.

See every shared feature

  • Send ticks and picks without approval

    Pages with no approval step, such as a status report or a review, send your ticks, picks and comments with Send answers.

  • Draw around a part and comment on it

    Draw mode takes a pen colour and a freehand stroke. Box a table or a group of rows, and the note covers each part inside.

  • Write a general comment

    A note about the whole doc rather than one spot goes in the field at the foot of the Comments panel. It lists first.

How the agent uses it

The agent writes JSON. The server draws the page.

The agent fills the skeleton, including the hero stat: one number, an icon and a label. The tldr states the answer and agrees with it.

python3 <skill>/scripts/build.py new other docs/status/week-41.bluedoc.json --title "Acme shop status, week 41" --kind Status
python3 <skill>/scripts/build.py docs/status/week-41.bluedoc.json
python3 <skill>/scripts/serve.py open docs/status/week-41.bluedoc.json
acme-status.bluedoc.json · the top of the page
{  "id": "acme-status",  "title": "Acme shop status, week 41",  "meta": { "org": "Acme Corp", "kind": "Status", "type": "other", "rev": "1" },  "hero": {    "icon": "box",    "value": "18,420",    "label": "orders placed, week 41"  },  "tldr": "The shop took 18,420 orders, 6% more than week 40. One decision is open: when to start the saved carts rollout."}

meta.kind is a free label: "Status", "Report", "Inventory". Without a hero the home card shows the section count.

Install

Pick your agent.

Each one installs the same skill from the GitHub repository.

claude plugin marketplace add andreiverdes/bluedoc
claude plugin install bluedoc@bluedoc

Inside a session the same commands are /plugin marketplace add andreiverdes/bluedoc and /plugin install bluedoc@bluedoc. Start a new session to load the skill.

Needs: Python 3.9 or later on PATH · git, for code reviews · gh, only to import GitHub review threads.

View on GitHub

Other doc types

Six more kinds of page.