discover-tasks

npx skills add agent-sh/agentsys --skill discover-tasks --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# discover-tasks Discover tasks from configured sources, validate them, and present for user selection. ## When to Use Invoked during Phase 2 of `/next-task` workflow, after policy selection. Also usable standalone when the user wants to discover and select tasks from configured sources. ## Workflow ### Phase 1: Load Policy and Claimed Tasks ```javascript // Use relative path from skill directory to plugin lib // Path: skills/discover-tasks/ -> ../../lib/state/workflow-state.js const workflowState = require('../../lib/state/workflow-state.js'); const state = workflowState.readState(); const policy = state.policy; // Load claimed task IDs from registry (tasks[] contains worktree-manager claims) const tasksRegistry = workflowState.readTasks(); const claimedIds = new Set(tasksRegistry.tasks.map(t => t.id)); ``` ### Phase 2: Fetch Tasks by Source **Source types:** - `github` / `gh-issues`: GitHub CLI - `gh-projects`: GitHub Projects (v2 boards) - `gitlab`: GitLab CLI - `local` / `tasks-md`: Local markdown files - `custom`: CLI/MCP/Skill tool - `other`: Agent interprets description **GitHub Issues:** ```bash # Fetch with pagination awareness gh issue list --state open \ --json number,ti

Fetch with pagination awareness
gh issue list --state open \
glab issue list --state opened --output json --per-page 100 > /tmp/glab-issues.json
for f in PLAN.md tasks.md TODO.md; do
done
Requires 'project' token scope. If permission error: gh auth refresh -s project
gh project item-list "$PROJECT_NUMBER" --owner "$OWNER" --format json --limit 100 > /tmp/gh-project-items.json
Only run when policy.taskSource?.source is 'github', 'gh-issues', or 'gh-projects'
gh pr list --state open --json number,title,body,headRefName --limit 100 > /tmp/gh-prs.json
Only run for GitHub sources (github, gh-issues, gh-projects). Use policy.taskSource?.source from Phase 1 to check.