skills.rest
davidsneighbour
davidsneighbourCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

project-task-triage

Syncs local TODO.md notes with GitHub Issues and regenerates the PROJECT.md dashboard.

1|Updated Aug 18, 2026
Search Tags:#project management#issue tracking#github issues#repository maintenance#project dashboard#task triage#todo sync
One-click install
npx skills add https://github.com/davidsneighbour/clerkwork --skill project-task-triage-davidsneighbour
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-task-triage
Source: https://github.com/davidsneighbour/clerkwork/tree/main/skills/project-task-triage
Command: npx skills add https://github.com/davidsneighbour/clerkwork --skill project-task-triage-davidsneighbour

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Local task notes and GitHub Issues drift apart over time, leaving duplicate todos, stale dashboards, and unclear next steps. This Skill reconciles the three tracking layers (GitHub Issues, PROJECT.md, TODO.md) so the issue tracker stays the single source of truth. ## Core Features & Use Cases - Issue Reconciliation: Converts actionable TODO.md notes into well-formed GitHub issues with context, acceptance criteria, and dependencies, and removes items already tracked. - Dashboard Regeneration: Rebuilds PROJECT.md from open issues only, grouped by topic with health indicators, dependency notes, and recommended next steps. - Git Hygiene Enforcement: Ensures PROJECT.md and TODO.md are gitignored and untracked, migrates legacy ROADMAP.md setups, and prevents project-management-only commits. - Use Case: After a week of jotting ideas into TODO.md, run a triage pass to file new issues, close completed ones, and get a fresh PROJECT.md showing what to work on next. ## Quick Start Use the project-task-triage skill to sync my TODO.md with GitHub Issues and regenerate the PROJECT.md dashboard.

Frequently Asked Questions about project-task-triage

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

FAQPage Schema
How do I sync a local TODO file with GitHub Issues?▼

Run the triage procedure, which reads TODO.md, fetches current GitHub issues, creates one issue per actionable item, and removes notes already covered by existing issues. Unclear notes stay in TODO.md with clarification markers.

How to generate a project status dashboard from GitHub issues?▼

The Skill rebuilds PROJECT.md from open issues only, grouped by topic with issue links, dependency notes, health indicators like test and lint status, and a recommended order of work. Closed issues never appear as entries.

Should PROJECT.md and TODO.md be committed to Git?▼

No. Both files are local working state and must be excluded via root .gitignore patterns /PROJECT.md and /TODO.md. The Skill verifies they are untracked and unstaged, and never creates project-management-only commits.

What happens to closed issues in the project dashboard?▼

Closed issues are removed from PROJECT.md unconditionally, even if closed during the same run. If a closed issue is a subtask of an open parent, the parent's entry gets a progress note such as "3 of 5 subtasks closed" instead.

Can this skill migrate an existing ROADMAP.md file?▼

Yes. If ROADMAP.md exists, its content is preserved and renamed to PROJECT.md, repository references are updated, ignore rules are added, and the files are removed from the Git index without deleting local copies.

When does the triage skill close a GitHub issue?▼

An issue is closed only when completion is clear from repository state, issue discussion, or project files, with a short explanation. When completion is uncertain, the Skill adds a note or clarification question instead of closing.

Related Skills

Explore More Product & Management Skills→
AMDResearchAMDResearch
3

feedback

Collect user feedback and file GitHub issues or local reports.

Official
Intermediate
dmooneydmooney

backlog

Organizes GitHub issue backlog via triage, fix-one, and drain modes.

Community
Advanced
EmasoftEmasoft

eia-label-taxonomy

Apply GitHub label taxonomy for PR reviews, issue triage, and status updates.

Community
Intermediate
jolequesjoleques

jira-workflow

Synchronize Jira tickets with Markdown documentation in a structured folder hierarchy.

Community
Intermediate