problem-tracking

Track open problems, issues, and suggestions in chat with explicit state machines.

Updated Nov 21, 2025
One-click install
npx skills add https://github.com/alatyshau/duet --skill problem-tracking-alatyshau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: problem-tracking
Source: https://github.com/alatyshau/duet/tree/main/packages/skills/modes/problem-tracking
Command: npx skills add https://github.com/alatyshau/duet --skill problem-tracking-alatyshau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In long design or planning chats, open questions, pending decisions, and unresolved suggestions drown in the message flow. This Skill makes tracking explicit: every problem, issue, and suggestion gets a numbered entity with a defined status, and every agent message ends with a roll of what is still open. ## Core Features & Use Cases - Explicit state machines: Problems (P) move through open, clarified, delivered, or canceled; Issues (I) open and close; Suggestions (S) are confirmed or declined — all with strict transition rules. - Ambiguity safety: Soft or ambiguous user replies ("probably", homonyms, partial answers) become issues instead of self-served confirmations, preventing silent misinterpretation. - Mandatory Open Items block: Every message ends with a compact list of active entities, or a short blessing phrase when nothing is open. - Use Case: During a multi-hour architecture discussion, the user activates the skill so that every open design question is numbered (P1, I1_02, S1_01), scope expansions are flagged with a renamed! marker, and nothing agreed or pending is ever lost. ## Quick Start Tell the assistant to activate problem tracking mode for this conversation so every open question and decision is explicitly numbered and tracked.

Frequently Asked Questions about problem-tracking

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

FAQPage Schema
How do I track open questions and decisions in a long AI chat?

Activate problem tracking mode explicitly, and the assistant numbers every open problem (P1, P2...), issue, and suggestion with defined statuses. Each message ends with an Open Items line listing everything still unresolved, so nothing gets lost in the scrollback.

What counts as a problem in chat-based problem tracking?

A message becomes a problem only if it needs discussion, will create or change an artifact, and has a clear scope. Factual questions, obvious execution requests, and direct behavioral instructions are explicitly excluded by the three-criteria filter.

Does the skill activate automatically when a discussion gets complex?

No, the skill is strictly opt-in and activates only on an explicit user command. There is no topic-based auto-trigger, so normal conversations are never interrupted by tracking markers.

What happens when the user gives an ambiguous answer to a suggestion?

Ambiguous replies such as "probably", partial confirmations, or homonyms do not confirm the suggestion. Instead, the assistant opens a new issue attached to the problem and asks for clarification, keeping the suggestion open.

Is there a limit on how many problems can be tracked in one chat?

Yes, numbering stops at P9. When the user tries to open a tenth problem, the assistant warns them to start a new chat instead of creating P10, keeping the tracking scope manageable.