starloop

Prioritize todos from a folder using frontmatter and star role filters.

2|1|Updated Jul 15, 2022
One-click install
npx skills add https://github.com/homostellaris/starfocus --skill starloop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: starloop
Source: https://github.com/homostellaris/starfocus/tree/main/skills/starloop
Command: npx skills add https://github.com/homostellaris/starfocus --skill starloop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you decide which todo to tackle next by analyzing a folder of user-created todos and applying optional role-based filters to maintain momentum.

Core Features & Use Cases

  • Next-task prioritization: analyzes todos in a folder, ranks them by relevance and impact from frontmatter data, and suggests the top candidate.
  • Role-aware guidance: optionally filters tasks by a starRole to align with your current priorities.
  • Progress awareness: ignores completed todos and leverages _manifest.md and _asteroid-field.md / _wayfinder.md to adjust prioritization.

Quick Start

Ask the user for the todo folder path as the first argument and a star role filter as the second to start prioritizing.

Frequently Asked Questions about starloop

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

FAQPage Schema
How do I decide which todo to work on next when I have too many tasks?

Next-task prioritization analyzes a folder of user-created todos, ranks them by relevance and impact from frontmatter data, and suggests the top candidate to reduce decision fatigue.

How do I filter my todo list to match my current role or focus?

Role-aware guidance filters tasks by a starRole to align with your current priorities. You provide a star role filter as the second argument to start prioritizing matching todos.

Can I use this task prioritization system if some of my todos are already completed?

Yes, progress awareness ignores completed todos by checking the completedAt frontmatter. It leverages this to adjust prioritization and only surface actionable items.

What metadata do I need in my todo files to enable automated prioritization?

Todo files require frontmatter with id, title, starRole, starPoints, and completedAt. Optional metadata from _manifest.md, _asteroid-field.md, and _wayfinder.md further adjusts prioritization.

What's the best way to start prioritizing my workflow tasks automatically?

Ask for the todo folder path as the first argument and a star role filter as the second. The system then reads the frontmatter to produce a prioritized shortlist with a top recommendation.