todo-writer

Create org-mode TODOs with single-sentence goals and Bobert prompts.

Updated Mar 29, 2024
One-click install
npx skills add https://github.com/addisonbeck/nix --skill todo-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo-writer
Source: https://github.com/addisonbeck/nix/tree/main/bobert/skills/todo-writer
Command: npx skills add https://github.com/addisonbeck/nix --skill todo-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables consistent, well-structured TODO creation by enforcing single-sentence goals, a Bobert-from-Addison conversational prompt, memory backlinks, and strict org-mode formatting to drive executable workflows.

Core Features & Use Cases

  • Goal-Prompt Structure Enforcement: Ensures every TODO contains a single-sentence goal and a conversational prompt to Bobert from Addison's perspective.
  • Orchestration Guidance Validation: Blocks incomplete TODOs when orchestration details are missing, requiring explicit workflow_skill, workflow_rationale, agent_sequence, and execution_steps.
  • Deep Memory Linking: Mandates backlinks to memory nodes using the org-roam syntax [[id:UUID][Description]] to connect TODOs with context.
  • Org-Mode Markup Expertise: Enforces proper heading hierarchy, code blocks, properties drawers, and rich formatting for org-mode docs.
  • SMART Requirements Analysis: Validates that TODOs meet Specific, Measurable, Achievable, Relevant, and Time-bound criteria within a single sentence.
  • Memory-Context-aware Pattern Selection: Adapts approach based on task type (Jira tickets, personal projects, bugs, features) using read_memory as needed.
  • Metacognitive Awareness: Encourages uncertainty acknowledgement, fallback strategies, and questions for low-confidence areas.

Quick Start

Draft a single-sentence TODO that includes a front-matter, a Goal, a Prompt, and a clear Workflow with explicit actor roles.

Frequently Asked Questions about todo-writer

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

FAQPage Schema
How do I create structured TODOs with SMART goals in org-mode?

To create structured TODOs with SMART goals in org-mode, draft a single-sentence goal and a conversational prompt, then validate explicit orchestration fields and memory backlinks. This ensures your TODO meets Specific, Measurable, Achievable, Relevant, and Time-bound criteria.

What is the best way to enforce workflow orchestration details when creating TODO items?

The best way to enforce workflow orchestration details is to block incomplete TODOs when mandatory fields are missing, requiring explicit workflow_skill, workflow_rationale, agent_sequence, and execution_steps. This validation prevents incomplete TODOs from entering your workflow.

Can I link org-mode TODOs to memory nodes for context tracking?

Yes, you can link org-mode TODOs to memory nodes by mandating backlinks using the org-roam syntax [[id:UUID][Description]]. This deep memory linking connects your TODOs directly with required contextual memory nodes.

Do I need to specify actor roles for bug fixes and feature development TODOs?

Yes, you need to specify explicit actor roles for bug fixes and feature development TODOs by defining agent responsibilities. The TODO must include bobert_responsibilities and addison_responsibilities within the orchestration guidance.

Why does my TODO validation fail when orchestration fields are missing?

TODO validation fails when orchestration fields are missing because the system blocks incomplete TODOs that lack explicit workflow_skill, workflow_rationale, agent_sequence, and execution_steps. These mandatory fields ensure executable workflows.

What are the limitations of using single-sentence goals for Jira tickets?

The limitation of using single-sentence goals for Jira tickets is that the goal must satisfy all SMART criteria within that single sentence. If the goal cannot be condensed while remaining Specific, Measurable, Achievable, Relevant, and Time-bound, validation will fail.