task-selection-advisor

Ranks documented task candidates into read-only next-work recommendations in three advisory modes.

3|2|Updated Jul 3, 2026
One-click install
npx skills add https://github.com/escogido/knowledge-cairn --skill task-selection-advisor-escogido
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-selection-advisor
Source: https://github.com/escogido/knowledge-cairn/tree/main/system/.agents/skills/task-selection-advisor
Command: npx skills add https://github.com/escogido/knowledge-cairn --skill task-selection-advisor-escogido

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a task finishes, deciding what to work on next requires re-reading scattered project docs and half-remembered priorities. This Skill reads the repository's documented candidates and operational state to produce a read-only, evidence-grounded recommendation without ever selecting, defining, or implementing work itself. ## Core Features & Use Cases - Three advisory modes: a bare candidate list, a fast ranked suggestion from loaded documentation (default), and a verified suggestion that checks candidates against current repository reality. - Candidate-list hygiene: flags stale, superseded, contradicted, or partially done candidates and surfaces documented-but-untracked work as capture suggestions. - Readiness ranking with lenses: orders candidates by observable readiness, separates waiting-on-other-work from blocked items, and supports quick-win or cleanup ranking lenses. - Use Case: After finishing a task, ask what to work on next and receive a ranked ready list with a recommendation, tie-break rationale, and the pickup command (do or define) for the suggested candidate. ## Quick Start Ask the assistant what to work on next to get a ranked recommendation from the documented candidates.

Frequently Asked Questions about task-selection-advisor

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

FAQPage Schema
How do I get a recommendation for what to work on next?

Ask what to work on next and the skill runs its default fast suggestion mode, ranking documented candidates from loaded operational evidence. It outputs a ready list, a recommendation with a tie-break, and the pickup command for the suggested candidate.

What is the difference between fast suggestion and verified suggestion?

Fast suggestion ranks candidates from documented text and loaded operational evidence without re-verifying, and labels the ranking as not freshly reverified. Verified suggestion additionally checks candidates against current code, tests, and repository reality, and is used for cleanup, reconciliation, or risky claims.

Can the task selection advisor pick or start a task for me?

No. The skill is strictly read-only and advisory: it never selects, defines, writes, or implements work. Applying its reconciliation suggestions or starting a recommended task is a separate human-gated step performed by the invoker or user.

When should I use the list mode instead of a suggestion?

Use list mode when you only want the live candidates with their stored pickup commands and one-line descriptions, in candidates.md order. It is a mechanical projection of the file with no ranking or verification, making it the cheap stable index for do or define commands.

How does the advisor handle blocked or stale candidates?

It separates not-ready candidates into waiting-on-other-work (a sequencing preference) and blocked (a hard obstacle), and never ranks blocked or stale candidates up. In verified suggestion it flags stale, superseded, contradicted, or partially done candidates for human-approved cleanup.