Skald

Title

Status Assignee Tags Blocked by

Parent

Body (Markdown)

Add a note

Help

Board

n New story

/ Focus the filter

g Toggle the dependency graph

? This help

Tab Move between cards

Enter Open the focused card

Esc Close a dialog or popover

Drag a card to move or reorder it

Selecting several cards

Press and hold a card (or x on a focused card) to start a selection

Click other cards in that column to add or remove them

Drag any selected card to move the whole batch

The bar at the bottom moves, tags, or archives the batch

Click in another column or press Esc to finish

Cards

Red edge: blocked by an unmet dependency

Amber edge: stale, no update for a while

also x@branch Claimed by someone on another branch or in another checkout

? 2 Open questions, waiting on a human; the modal lists them as Q1, Q2, ..., Answer beside one closes it alone, and Answer all closes every one. Only a reply from here or skald answer closes a question; a plain decision note does not

Children done over total, on a parent story; the dialog lists them and can add one

Acceptance checklist progress

Header

Branch shows a read-only view of the backlog on another branch, or another checkout of this project (a worktree or clone): its working tree, editable, uncommitted changes included

Commit appears when story files have uncommitted changes

Swimlanes group the board by a key:value tag such as epic:auth

All projects lists ready, unblocked work across every registered project

Every story is one Markdown file in .skald/stories/, committed with the code it describes. The file name carries the id, so a3f9c2-add-login.md is story a3f9c2.

---
title: "Add login"
status: "ready"
rank: 20
tags: ["auth", "epic:accounts"]
blocked_by: ["b7d1e0", "other-project:44ac1e"]
assignee: "claude"
created_at: "2026-09-06T02:16:15Z"
updated_at: "2026-09-06T07:04:41Z"
---
## Requirements
What done looks like.

## Acceptance
- [ ] Checklist items become the progress bar on the card

## [claude] 2026-09-06 07:04 UTC · handoff
Dated notes are appended by skald note or the Add a note box.

Frontmatter values are JSON literals, one per line. Columns, their roles, and WIP limits live in .skald/config.json. Everything under .skald/ is safe to edit by hand; run skald check afterwards.

Full documentation: README · SPEC