skills.rest
seal-harness
seal-harnessOFFICIAL
Explore all skills by this author →
GitHub

todo-md-maintenance

Adds, updates, and reads items in a project TODO.md file.

1|Updated Jun 23, 2026
Search Tags:#project management#markdown#github issues#todo#git commit#task tracking#checkbox
One-click install
npx skills add https://github.com/seal-harness/seal-harness --skill todo-md-maintenance-seal-harness
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: todo-md-maintenance
Source: https://github.com/seal-harness/seal-harness/tree/main/.agents/skills/todo-md-maintenance
Command: npx skills add https://github.com/seal-harness/seal-harness --skill todo-md-maintenance-seal-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's TODO.md current requires context switching and manual edits. This Skill lets any agent make targeted, single-item changes to TODO.md mid-conversation without launching a full maintenance session. ## Core Features & Use Cases - todo-add: Append one item to the correct section (Active Work, Known Issues, or Backlog) with proper formatting and a timestamp update. - todo-update: Change an item's checkbox status and move completed items to the Done section with a PR or date note. - todo-check: Read the current TODO.md to see what is planned, in progress, or done before starting work. - Use Case: During a coding session you discover a bug that needs a GitHub issue. Invoke todo-add to record it under Known Issues, commit the change, and continue working without losing context. ## Quick Start Ask the agent to add the issue we just discussed to the project TODO.md under Known Issues.

Frequently Asked Questions about todo-md-maintenance

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

FAQPage Schema
How do I add an item to TODO.md from a conversation?▼

Use the todo-add operation: read the current TODO.md, pick the right section (Active Work, Known Issues, or Backlog), append the item in the existing format, update the timestamp comment, and commit with git. Only one item is added per invocation.

How do I mark a TODO.md item as done?▼

Use todo-update to change the checkbox from [ ] or [~] to [x], then move the item to the top of the Done section with a brief note such as a PR reference or date. Update the timestamp comment and commit the change.

When should I use the todo-manager agent instead of this skill?▼

Use the todo-manager agent for full maintenance: syncing TODO.md with all GitHub issues, reconciling phases, restructuring sections, or generating standup reports. This skill only handles targeted single-item edits.

What checkbox format does TODO.md use?▼

The format uses three states: - [ ] for not started, - [~] for in progress, and - [x] for done. Items move between sections like Active Work, Known Issues, Backlog, and Done as their status changes.

What happens if the item already exists in TODO.md?▼

The skill scans for a matching issue number or very similar title before adding. If a duplicate is found, it does not add the item and instead tells the user it is already tracked.

Related Skills

Explore More Software Engineering Skills→
githubgithub
38.5k

create-github-issues-feature-from-implementation-plan

Creates GitHub Issues from implementation plan phases using feature or chore request templates.

Official
Basic
nexus-substratenexus-substrate
18

system-review

Reconcile technique registries, sync documentation, and audit GitHub issue hygiene.

Official
Intermediate
marcusgollmarcusgoll

deep-status

Aggregate deep loop session state from .deep-* files into status reports.

Community
Intermediate
GatePass-SecurityGatePass-Security

speckit-taskstoissues

Convert markdown task lists into dependency-ordered GitHub issues without duplicates.

Official
Advanced