kobold-housekeeping

Display tag-grouped todos as persistent floating panels in Pi agent workflows.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/dotBeeps/hoard --skill kobold-housekeeping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kobold-housekeeping
Source: https://github.com/dotBeeps/hoard/tree/main/morsels/skills/kobold-housekeeping
Command: npx skills add https://github.com/dotBeeps/hoard --skill kobold-housekeeping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage scattered work items and reduce context switching by surfacing tag-grouped todos as persistent, auto-updating overlays so you can keep task lists visible while you work.

Core Features & Use Cases

  • Persistent Overlays: Open floating panels that stay on screen and auto-refresh when the underlying todos change.
  • Tag-based Grouping: Group and display todos by tag to create focused views like sprint tasks, bugs, or inbox items.
  • Layout & Management Tools: Use suggest_layout for positioning recommendations and commands to open, close, focus, list, and refresh panels.
  • Use case: Triage sprint work by opening a sprint panel on the right-center while keeping an "all" panel available for global context.

Quick Start

Open a persistent right-center panel for the sprint tag at 30% width by invoking the todo_panel open command with tag sprint anchor right-center width 30%.

Frequently Asked Questions about kobold-housekeeping

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

FAQPage Schema
How do I display persistent floating panels for tagged todos?

To display persistent floating panels for tagged todos, you can invoke the todo_panel open command with specific parameters like tag, anchor, and width. The panels stay on screen and auto-refresh when underlying todos change.

Can I group todos by tag to create focused task views during work sessions?

Yes, you can group todos by tag to create focused task views like sprint tasks or bugs. The system organizes and surfaces tagged todos within persistent overlay panels for visible task management.

How do I position and manage overlay panels for task tracking?

You position and manage overlay panels for task tracking using the suggest_layout command for recommendations, alongside commands to open, close, focus, list, and refresh panels. You can anchor panels right-center with specific widths.

Do I need the .pi/todos storage to use persistent todo panels?

Yes, the persistent todo panels integrate with the built-in .pi/todos storage. This integration allows the floating overlay panels to automatically read, display, and refresh tagged work items when changes occur.

Why use floating overlay panels instead of standard task lists for managing work items?

Floating overlay panels reduce context switching by keeping tag-grouped task lists visible on screen while you work. Unlike standard task lists, persistent overlays auto-refresh and stay accessible during interactive Pi agent workflows.