mismagent-board

Serves a read-only localhost kanban of feature building blocks scanned from todo, doing, and done folders.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lucolucus/mismagent --skill mismagent-board-lucolucus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mismagent-board
Source: https://github.com/lucolucus/mismagent/tree/main/codex/skills/mismagent-board
Command: npx skills add https://github.com/lucolucus/mismagent --skill mismagent-board-lucolucus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? During a mismAgent build, block state lives only in folder structure (blocks/<ctx>/{todo,doing,done}/<id>.md), making it hard to see overall progress at a glance. This Skill launches a live, read-only kanban board so you can watch the build without touching any files. ## Core Features & Use Cases - Live kanban view: Scans block files and serves a localhost page that refreshes every ~1.5 seconds, with status derived from the folder (todo/doing/done). - Read-only guarantee: Never writes or moves block files; only the worker-composer changes state, keeping the method's invariants intact. - Open-question badges: Blocks parked with a sibling open-questions/<block-id>.md show a ⏳ badge, and structural spec gaps (missing What-to-do or criteria) are flagged. - Use Case: While /mismagent:worker-composer runs a build, launch the board in the background and watch blocks flow from todo to done, spotting parked blocks the moment they need your input. ## Quick Start Ask the AI to launch the mismagent board for your feature directory in the background and report the localhost URL it prints.

Frequently Asked Questions about mismagent-board

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch the mismAgent board for a feature?

Run python3 scripts/board.py with the feature directory (e.g. .mismagent/features/<feature>) in the background. It prints a http://127.0.0.1:<port> URL that you open in a browser; the page refreshes roughly every 1.5 seconds.

How does the board determine each block's status?

Status is the folder the block file lives in: todo, doing, or done under blocks/<context>/. The board never writes files; only the worker-composer moves blocks between folders.

Does the board require any Python packages to be installed?

No. The board uses only the Python 3 standard library (http.server, argparse, json, re), so it runs with zero dependencies on any machine with Python 3.

What does the hourglass badge on a board card mean?

The ⏳ badge means the block is parked on an open question: a sibling open-questions/<block-id>.md file exists, written by the worker-composer when it bounced and is awaiting user input.

What happens if multiple features exist under the project root?

If you pass the project root and several features exist under features/, the board exits and asks you to pass one feature explicitly. With a single feature it auto-resolves it.