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.